Fossil SCM
Updated all of "fossil help *-glob" output to refer to the syntax docs instead of repeating the parsing rules in each setting, incorrectly. (If URLs in help output are verboten, then we need to repeat the rules *correctly* in each setting's help.)
Commit
7dc0433b547728039878d5f7d0ddcaf95f2966a4539230fce406d31064afba7d
Parent
b293b265a695c99…
1 file changed
+30
-28
M
src/db.c
+30
-28
| --- src/db.c | ||
| +++ src/db.c | ||
| @@ -4159,13 +4159,14 @@ | ||
| 4159 | 4159 | ** every time the backoffice runs. This can be used for debugging, |
| 4160 | 4160 | ** to ensure that backoffice is running appropriately. |
| 4161 | 4161 | */ |
| 4162 | 4162 | /* |
| 4163 | 4163 | ** SETTING: binary-glob width=40 versionable block-text |
| 4164 | -** The VALUE of this setting is a comma or newline-separated list of | |
| 4165 | -** GLOB patterns that should be treated as binary files | |
| 4166 | -** for committing and merging purposes. Example: *.jpg | |
| 4164 | +** The VALUE of this setting is a list of GLOB patterns matching files | |
| 4165 | +** that should be treated as "binary" for committing and merging | |
| 4166 | +** purposes. Example: *.jpg,*.png The parsing rules are complex; | |
| 4167 | +** see https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax | |
| 4167 | 4168 | */ |
| 4168 | 4169 | #if defined(_WIN32)||defined(__CYGWIN__)||defined(__DARWIN__) |
| 4169 | 4170 | /* |
| 4170 | 4171 | ** SETTING: case-sensitive boolean default=off |
| 4171 | 4172 | ** If TRUE, the files whose names differ only in case |
| @@ -4183,14 +4184,14 @@ | ||
| 4183 | 4184 | ** TRUE for unix and FALSE for Cygwin, Mac and Windows. |
| 4184 | 4185 | */ |
| 4185 | 4186 | #endif |
| 4186 | 4187 | /* |
| 4187 | 4188 | ** SETTING: clean-glob width=40 versionable block-text |
| 4188 | -** The VALUE of this setting is a comma or newline-separated list of GLOB | |
| 4189 | -** patterns specifying files that the "clean" command will | |
| 4190 | -** delete without prompting or allowing undo. | |
| 4191 | -** Example: *.a,*.lib,*.o | |
| 4189 | +** The VALUE of this setting is a list of GLOB patterns matching files | |
| 4190 | +** that the "clean" command will delete without prompting or allowing | |
| 4191 | +** undo. Example: *.a,*.o,*.so The parsing rules are complex; | |
| 4192 | +** see https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax | |
| 4192 | 4193 | */ |
| 4193 | 4194 | /* |
| 4194 | 4195 | ** SETTING: clearsign boolean default=off |
| 4195 | 4196 | ** When enabled, fossil will attempt to sign all commits |
| 4196 | 4197 | ** with gpg. When disabled, commits will be unsigned. |
| @@ -4218,15 +4219,15 @@ | ||
| 4218 | 4219 | ** Note: The options for timeline comments displayed on the web UI can be |
| 4219 | 4220 | ** configured through the /setup_timeline web page. |
| 4220 | 4221 | */ |
| 4221 | 4222 | /* |
| 4222 | 4223 | ** SETTING: crlf-glob width=40 versionable block-text |
| 4223 | -** The value is a comma or newline-separated list of GLOB patterns for | |
| 4224 | -** text files in which it is ok to have CR, CR+LF or mixed | |
| 4225 | -** line endings. Set to "*" to disable CR+LF checking. | |
| 4224 | +** The VALUE of this setting is a list of GLOB patterns matching files | |
| 4225 | +** in which it is allowed to have CR, CR+LF or mixed line endings, | |
| 4226 | +** suppressing Fossil's normal warning about this. Set it to "*" to | |
| 4227 | +** disable CR+LF checking entirely. Example: *.md,*.txt | |
| 4226 | 4228 | ** The crnl-glob setting is a compatibility alias. |
| 4227 | -*/ | |
| 4228 | 4229 | /* |
| 4229 | 4230 | ** SETTING: crnl-glob width=40 versionable block-text |
| 4230 | 4231 | ** This is an alias for the crlf-glob setting. |
| 4231 | 4232 | */ |
| 4232 | 4233 | /* |
| @@ -4273,15 +4274,15 @@ | ||
| 4273 | 4274 | ** exists with that name, an empty directory will be be created, even if |
| 4274 | 4275 | ** it must create one or more parent directories. |
| 4275 | 4276 | */ |
| 4276 | 4277 | /* |
| 4277 | 4278 | ** SETTING: encoding-glob width=40 versionable block-text |
| 4278 | -** The value is a comma or newline-separated list of GLOB | |
| 4279 | -** patterns specifying files that the "commit" command will | |
| 4280 | -** ignore when issuing warnings about text files that may | |
| 4281 | -** use another encoding than ASCII or UTF-8. Set to "*" | |
| 4282 | -** to disable encoding checking. | |
| 4279 | +** The VALUE of this setting is a list of GLOB patterns matching files that | |
| 4280 | +** the "commit" command will ignore when issuing warnings about text files | |
| 4281 | +** that may use another encoding than ASCII or UTF-8. Set to "*" to disable | |
| 4282 | +** encoding checking. Example: *.md,*.txt The parsing rules are complex; | |
| 4283 | +** see https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax | |
| 4283 | 4284 | */ |
| 4284 | 4285 | #if defined(FOSSIL_ENABLE_EXEC_REL_PATHS) |
| 4285 | 4286 | /* |
| 4286 | 4287 | ** SETTING: exec-rel-paths boolean default=on |
| 4287 | 4288 | ** When executing certain external commands (e.g. diff and |
| @@ -4296,14 +4297,15 @@ | ||
| 4296 | 4297 | */ |
| 4297 | 4298 | #endif |
| 4298 | 4299 | |
| 4299 | 4300 | /* |
| 4300 | 4301 | ** SETTING: fileedit-glob width=40 block-text |
| 4301 | -** A comma- or newline-separated list of globs of filenames | |
| 4302 | -** which are allowed to be edited using the /fileedit page. | |
| 4303 | -** An empty list prohibits editing via that page. Note that | |
| 4304 | -** it cannot edit binary files, so the list should not | |
| 4302 | +** The VALUE of this setting is a list of GLOB patterns matching files | |
| 4303 | +** which are allowed to be edited using the /fileedit page. An empty list | |
| 4304 | +** suppresses the feature. Example: *.md,*.txt The parsing rules are | |
| 4305 | +** complex; see https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax | |
| 4306 | +** Note that /fileedit cannot edit binary files, so the list should not | |
| 4305 | 4307 | ** contain any globs for, e.g., images or PDFs. |
| 4306 | 4308 | */ |
| 4307 | 4309 | /* |
| 4308 | 4310 | ** SETTING: forbid-delta-manifests boolean default=off |
| 4309 | 4311 | ** If enabled on a client, new delta manifests are prohibited on |
| @@ -4341,21 +4343,21 @@ | ||
| 4341 | 4343 | ** If true, then the Fossil web server will redirect unencrypted |
| 4342 | 4344 | ** login screen requests to HTTPS. |
| 4343 | 4345 | */ |
| 4344 | 4346 | /* |
| 4345 | 4347 | ** SETTING: ignore-glob width=40 versionable block-text |
| 4346 | -** The value is a list of GLOB patterns, separated by spaces, | |
| 4347 | -** commas, or newlines, specifying files that the "add", | |
| 4348 | -** "addremove", "clean", and "extras" commands will ignore. | |
| 4349 | -** | |
| 4350 | -** Example: *.log, customCode.c, notes.txt | |
| 4348 | +** The VALUE of this setting is a list of GLOB patterns matching files that | |
| 4349 | +** the "add", "addremove", "clean", and "extras" commands will ignore. | |
| 4350 | +** Example: *.log,notes.txt The parsing rules are complex; see | |
| 4351 | +** https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax | |
| 4351 | 4352 | */ |
| 4352 | 4353 | /* |
| 4353 | 4354 | ** SETTING: keep-glob width=40 versionable block-text |
| 4354 | -** The value is list of GLOB patterns, separated by spaces, | |
| 4355 | -** commas, or newlines, specifying files that the "clean" | |
| 4356 | -** command will keep. | |
| 4355 | +** The VALUE of this setting is a list of GLOB patterns matching files that | |
| 4356 | +** the "clean" command must not delete. Example: build/precious.exe | |
| 4357 | +** The parsing rules are complex; see | |
| 4358 | +** https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax | |
| 4357 | 4359 | */ |
| 4358 | 4360 | /* |
| 4359 | 4361 | ** SETTING: localauth boolean default=off |
| 4360 | 4362 | ** If enabled, require that HTTP connections from the loopback |
| 4361 | 4363 | ** address (127.0.0.1) be authenticated by password. If false, |
| 4362 | 4364 |
| --- src/db.c | |
| +++ src/db.c | |
| @@ -4159,13 +4159,14 @@ | |
| 4159 | ** every time the backoffice runs. This can be used for debugging, |
| 4160 | ** to ensure that backoffice is running appropriately. |
| 4161 | */ |
| 4162 | /* |
| 4163 | ** SETTING: binary-glob width=40 versionable block-text |
| 4164 | ** The VALUE of this setting is a comma or newline-separated list of |
| 4165 | ** GLOB patterns that should be treated as binary files |
| 4166 | ** for committing and merging purposes. Example: *.jpg |
| 4167 | */ |
| 4168 | #if defined(_WIN32)||defined(__CYGWIN__)||defined(__DARWIN__) |
| 4169 | /* |
| 4170 | ** SETTING: case-sensitive boolean default=off |
| 4171 | ** If TRUE, the files whose names differ only in case |
| @@ -4183,14 +4184,14 @@ | |
| 4183 | ** TRUE for unix and FALSE for Cygwin, Mac and Windows. |
| 4184 | */ |
| 4185 | #endif |
| 4186 | /* |
| 4187 | ** SETTING: clean-glob width=40 versionable block-text |
| 4188 | ** The VALUE of this setting is a comma or newline-separated list of GLOB |
| 4189 | ** patterns specifying files that the "clean" command will |
| 4190 | ** delete without prompting or allowing undo. |
| 4191 | ** Example: *.a,*.lib,*.o |
| 4192 | */ |
| 4193 | /* |
| 4194 | ** SETTING: clearsign boolean default=off |
| 4195 | ** When enabled, fossil will attempt to sign all commits |
| 4196 | ** with gpg. When disabled, commits will be unsigned. |
| @@ -4218,15 +4219,15 @@ | |
| 4218 | ** Note: The options for timeline comments displayed on the web UI can be |
| 4219 | ** configured through the /setup_timeline web page. |
| 4220 | */ |
| 4221 | /* |
| 4222 | ** SETTING: crlf-glob width=40 versionable block-text |
| 4223 | ** The value is a comma or newline-separated list of GLOB patterns for |
| 4224 | ** text files in which it is ok to have CR, CR+LF or mixed |
| 4225 | ** line endings. Set to "*" to disable CR+LF checking. |
| 4226 | ** The crnl-glob setting is a compatibility alias. |
| 4227 | */ |
| 4228 | /* |
| 4229 | ** SETTING: crnl-glob width=40 versionable block-text |
| 4230 | ** This is an alias for the crlf-glob setting. |
| 4231 | */ |
| 4232 | /* |
| @@ -4273,15 +4274,15 @@ | |
| 4273 | ** exists with that name, an empty directory will be be created, even if |
| 4274 | ** it must create one or more parent directories. |
| 4275 | */ |
| 4276 | /* |
| 4277 | ** SETTING: encoding-glob width=40 versionable block-text |
| 4278 | ** The value is a comma or newline-separated list of GLOB |
| 4279 | ** patterns specifying files that the "commit" command will |
| 4280 | ** ignore when issuing warnings about text files that may |
| 4281 | ** use another encoding than ASCII or UTF-8. Set to "*" |
| 4282 | ** to disable encoding checking. |
| 4283 | */ |
| 4284 | #if defined(FOSSIL_ENABLE_EXEC_REL_PATHS) |
| 4285 | /* |
| 4286 | ** SETTING: exec-rel-paths boolean default=on |
| 4287 | ** When executing certain external commands (e.g. diff and |
| @@ -4296,14 +4297,15 @@ | |
| 4296 | */ |
| 4297 | #endif |
| 4298 | |
| 4299 | /* |
| 4300 | ** SETTING: fileedit-glob width=40 block-text |
| 4301 | ** A comma- or newline-separated list of globs of filenames |
| 4302 | ** which are allowed to be edited using the /fileedit page. |
| 4303 | ** An empty list prohibits editing via that page. Note that |
| 4304 | ** it cannot edit binary files, so the list should not |
| 4305 | ** contain any globs for, e.g., images or PDFs. |
| 4306 | */ |
| 4307 | /* |
| 4308 | ** SETTING: forbid-delta-manifests boolean default=off |
| 4309 | ** If enabled on a client, new delta manifests are prohibited on |
| @@ -4341,21 +4343,21 @@ | |
| 4341 | ** If true, then the Fossil web server will redirect unencrypted |
| 4342 | ** login screen requests to HTTPS. |
| 4343 | */ |
| 4344 | /* |
| 4345 | ** SETTING: ignore-glob width=40 versionable block-text |
| 4346 | ** The value is a list of GLOB patterns, separated by spaces, |
| 4347 | ** commas, or newlines, specifying files that the "add", |
| 4348 | ** "addremove", "clean", and "extras" commands will ignore. |
| 4349 | ** |
| 4350 | ** Example: *.log, customCode.c, notes.txt |
| 4351 | */ |
| 4352 | /* |
| 4353 | ** SETTING: keep-glob width=40 versionable block-text |
| 4354 | ** The value is list of GLOB patterns, separated by spaces, |
| 4355 | ** commas, or newlines, specifying files that the "clean" |
| 4356 | ** command will keep. |
| 4357 | */ |
| 4358 | /* |
| 4359 | ** SETTING: localauth boolean default=off |
| 4360 | ** If enabled, require that HTTP connections from the loopback |
| 4361 | ** address (127.0.0.1) be authenticated by password. If false, |
| 4362 |
| --- src/db.c | |
| +++ src/db.c | |
| @@ -4159,13 +4159,14 @@ | |
| 4159 | ** every time the backoffice runs. This can be used for debugging, |
| 4160 | ** to ensure that backoffice is running appropriately. |
| 4161 | */ |
| 4162 | /* |
| 4163 | ** SETTING: binary-glob width=40 versionable block-text |
| 4164 | ** The VALUE of this setting is a list of GLOB patterns matching files |
| 4165 | ** that should be treated as "binary" for committing and merging |
| 4166 | ** purposes. Example: *.jpg,*.png The parsing rules are complex; |
| 4167 | ** see https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax |
| 4168 | */ |
| 4169 | #if defined(_WIN32)||defined(__CYGWIN__)||defined(__DARWIN__) |
| 4170 | /* |
| 4171 | ** SETTING: case-sensitive boolean default=off |
| 4172 | ** If TRUE, the files whose names differ only in case |
| @@ -4183,14 +4184,14 @@ | |
| 4184 | ** TRUE for unix and FALSE for Cygwin, Mac and Windows. |
| 4185 | */ |
| 4186 | #endif |
| 4187 | /* |
| 4188 | ** SETTING: clean-glob width=40 versionable block-text |
| 4189 | ** The VALUE of this setting is a list of GLOB patterns matching files |
| 4190 | ** that the "clean" command will delete without prompting or allowing |
| 4191 | ** undo. Example: *.a,*.o,*.so The parsing rules are complex; |
| 4192 | ** see https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax |
| 4193 | */ |
| 4194 | /* |
| 4195 | ** SETTING: clearsign boolean default=off |
| 4196 | ** When enabled, fossil will attempt to sign all commits |
| 4197 | ** with gpg. When disabled, commits will be unsigned. |
| @@ -4218,15 +4219,15 @@ | |
| 4219 | ** Note: The options for timeline comments displayed on the web UI can be |
| 4220 | ** configured through the /setup_timeline web page. |
| 4221 | */ |
| 4222 | /* |
| 4223 | ** SETTING: crlf-glob width=40 versionable block-text |
| 4224 | ** The VALUE of this setting is a list of GLOB patterns matching files |
| 4225 | ** in which it is allowed to have CR, CR+LF or mixed line endings, |
| 4226 | ** suppressing Fossil's normal warning about this. Set it to "*" to |
| 4227 | ** disable CR+LF checking entirely. Example: *.md,*.txt |
| 4228 | ** The crnl-glob setting is a compatibility alias. |
| 4229 | /* |
| 4230 | ** SETTING: crnl-glob width=40 versionable block-text |
| 4231 | ** This is an alias for the crlf-glob setting. |
| 4232 | */ |
| 4233 | /* |
| @@ -4273,15 +4274,15 @@ | |
| 4274 | ** exists with that name, an empty directory will be be created, even if |
| 4275 | ** it must create one or more parent directories. |
| 4276 | */ |
| 4277 | /* |
| 4278 | ** SETTING: encoding-glob width=40 versionable block-text |
| 4279 | ** The VALUE of this setting is a list of GLOB patterns matching files that |
| 4280 | ** the "commit" command will ignore when issuing warnings about text files |
| 4281 | ** that may use another encoding than ASCII or UTF-8. Set to "*" to disable |
| 4282 | ** encoding checking. Example: *.md,*.txt The parsing rules are complex; |
| 4283 | ** see https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax |
| 4284 | */ |
| 4285 | #if defined(FOSSIL_ENABLE_EXEC_REL_PATHS) |
| 4286 | /* |
| 4287 | ** SETTING: exec-rel-paths boolean default=on |
| 4288 | ** When executing certain external commands (e.g. diff and |
| @@ -4296,14 +4297,15 @@ | |
| 4297 | */ |
| 4298 | #endif |
| 4299 | |
| 4300 | /* |
| 4301 | ** SETTING: fileedit-glob width=40 block-text |
| 4302 | ** The VALUE of this setting is a list of GLOB patterns matching files |
| 4303 | ** which are allowed to be edited using the /fileedit page. An empty list |
| 4304 | ** suppresses the feature. Example: *.md,*.txt The parsing rules are |
| 4305 | ** complex; see https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax |
| 4306 | ** Note that /fileedit cannot edit binary files, so the list should not |
| 4307 | ** contain any globs for, e.g., images or PDFs. |
| 4308 | */ |
| 4309 | /* |
| 4310 | ** SETTING: forbid-delta-manifests boolean default=off |
| 4311 | ** If enabled on a client, new delta manifests are prohibited on |
| @@ -4341,21 +4343,21 @@ | |
| 4343 | ** If true, then the Fossil web server will redirect unencrypted |
| 4344 | ** login screen requests to HTTPS. |
| 4345 | */ |
| 4346 | /* |
| 4347 | ** SETTING: ignore-glob width=40 versionable block-text |
| 4348 | ** The VALUE of this setting is a list of GLOB patterns matching files that |
| 4349 | ** the "add", "addremove", "clean", and "extras" commands will ignore. |
| 4350 | ** Example: *.log,notes.txt The parsing rules are complex; see |
| 4351 | ** https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax |
| 4352 | */ |
| 4353 | /* |
| 4354 | ** SETTING: keep-glob width=40 versionable block-text |
| 4355 | ** The VALUE of this setting is a list of GLOB patterns matching files that |
| 4356 | ** the "clean" command must not delete. Example: build/precious.exe |
| 4357 | ** The parsing rules are complex; see |
| 4358 | ** https://fossil-scm.org/home/doc/trunk/www/globs.md#syntax |
| 4359 | */ |
| 4360 | /* |
| 4361 | ** SETTING: localauth boolean default=off |
| 4362 | ** If enabled, require that HTTP connections from the loopback |
| 4363 | ** address (127.0.0.1) be authenticated by password. If false, |
| 4364 |