conf: overhaul repository settings (#5932)

1 files changed, 24 insertions, 29 deletions

diff --git a/conf/app.ini b/conf/app.ini
index 036e2d28..8cda7efa 100644
--- a/conf/app.ini
+++ b/conf/app.ini
@@ -89,53 +89,48 @@ RSA     = 2048
 DSA     = 1024
 
 [repository]
-; Root path for storing repositories's data, default is "~/gogs-repositories"
+; The root path for storing managed repositories, default is "~/gogs-repositories"
 ROOT =
-; The script type server supports, sometimes could be "sh"
+; The script type server supports, sometimes could be "sh".
 SCRIPT_TYPE = bash
-; Default ANSI charset for an unrecognized charset
+; Default ANSI charset for an unrecognized charset.
 ANSI_CHARSET =
-; Force every new repository to be private
+; Whether to force every new repository to be private.
 FORCE_PRIVATE = false
-; Global maximum creation limit of repository per user, -1 means no limit
+; The global limit of number of repositories a user can create, -1 means no limit.
 MAX_CREATION_LIMIT = -1
-; Mirror sync queue length, increase if mirror syncing starts hanging
-MIRROR_QUEUE_LENGTH = 1000
-; Patch test queue length, increase if pull request patch testing starts hanging
-PULL_REQUEST_QUEUE_LENGTH = 1000
-; Preferred Licenses to place at the top of the list
-; Name must match file name in conf/license or custom/conf/license
-PREFERRED_LICENSES = Apache License 2.0,MIT License
-; Disable ability to interact with repositories by HTTP protocol
+; Preferred Licenses to place at the top of the list.
+; Name must match file name in "conf/license" or "custom/conf/license".
+PREFERRED_LICENSES = Apache License 2.0, MIT License
+; Whether to disable Git interaction with repositories via HTTP/HTTPS protocol.
 DISABLE_HTTP_GIT = false
-; Enable ability to migrate repository by local path
+; Whether to enable ability to migrate repository by server local path.
 ENABLE_LOCAL_PATH_MIGRATION = false
-; Concurrency is used to retrieve commits information. This variable define
-; the maximum number of tasks that can be run at the same time. Usually, the
-; value depend of how many CPUs (cores) you have. If the value is set to zero
-; or under, Gogs will automatically detect the number of CPUs your system have
-COMMITS_FETCH_CONCURRENCY = 0
-; Enable render mode for raw file
+; Whether to enable render mode for raw file. There are potential security risks.
 ENABLE_RAW_FILE_RENDER_MODE = false
+; The maximum number of goroutines that can be run at the same time for a single
+; fetch request. Usually, the value depend of how many CPU (cores) you have. If
+; the value is non-positive, it matchs the number of CPUs available to the application.
+COMMITS_FETCH_CONCURRENCY = 0
 
 [repository.editor]
 ; List of file extensions that should have line wraps in the CodeMirror editor.
-; Separate extensions with a comma. To line wrap files without extension, just put a comma
-LINE_WRAP_EXTENSIONS = .txt,.md,.markdown,.mdown,.mkd,
-; Valid file modes that have a preview API associated with them, such as api/v1/markdown.
-; Separate values by commas. Preview tab in edit mode won't show if the file extension doesn't match
+; Separate extensions with a comma.
+LINE_WRAP_EXTENSIONS = .txt,.md,.markdown,.mdown,.mkd
+; Valid file modes that have a preview API associated with them, such as "/api/v1/markdown".
+; Separate values by commas. Preview tab in edit mode won't show if the file extension doesn't match.
 PREVIEWABLE_FILE_MODES = markdown
 
 [repository.upload]
-; Enable repository file uploads.
+; Whether to enable repository file uploads.
 ENABLED = true
-; Path to temporarily store uploads (default path gets cleaned by Gogs in every start)
+; The path to temporarily store uploads (content under this path gets wiped out on every start).
 TEMP_PATH = data/tmp/uploads
-; File types that are allowed to be uploaded, e.g. image/jpeg|image/png. Leave empty means allow any file type
+; File types that are allowed to be uploaded, e.g. "image/jpeg|image/png". Leave empty to allow any file type.
 ALLOWED_TYPES =
-; Maximum size of each file in MB
+; The maximum size of each file in MB.
 FILE_MAX_SIZE = 3
-; Maximum number of files per upload
+; The maximum number of files per upload.
 MAX_FILES = 5
 
 ; Attachment settings for releases