Fossil SCM
Improved on-line help for the allow-symlinks setting.
Commit
d3090e91b8a2bea3c12346a022c42405088969ddb3dcdb37ba70e2dd6c23d339
Parent
39a5df1fde741d0…
1 file changed
+14
-12
M
src/db.c
+14
-12
| --- src/db.c | ||
| +++ src/db.c | ||
| @@ -3551,22 +3551,24 @@ | ||
| 3551 | 3551 | ** in the "admin_log" table of the repository. |
| 3552 | 3552 | */ |
| 3553 | 3553 | /* |
| 3554 | 3554 | ** SETTING: allow-symlinks boolean default=off sensitive |
| 3555 | 3555 | ** |
| 3556 | -** When allow-symlinks is OFF (which is the default and recommended setting) | |
| 3557 | -** symbolic links a treated like text files that contain a single line of | |
| 3558 | -** content which is the name of their target. If allow-symlinks is ON, | |
| 3559 | -** the symbolic links are actually followed. | |
| 3560 | -** | |
| 3561 | -** The use of symbolic links is dangerous. If you checkout a maliciously | |
| 3562 | -** crafted checkin that contains symbolic links, it is possible that files | |
| 3563 | -** outside of the working directory might be overwritten. | |
| 3564 | -** | |
| 3565 | -** Keep this setting OFF unless you have a very good reason to turn it | |
| 3566 | -** on and you implicitly trust the integrity of the repositories you | |
| 3567 | -** open. | |
| 3556 | +** When allow-symlinks is OFF, Fossil does not see symbolic links on disk as | |
| 3557 | +** a separate class of object. Instead Fossil sess the object that the | |
| 3558 | +** symbolic link points to. Fossil will only manage with files and directories, | |
| 3559 | +** not symbolic links. When a symbolic link is added to a repository, the | |
| 3560 | +** object that the link points to is added, not the link itself. | |
| 3561 | +** | |
| 3562 | +** When allow-symlinks is ON, Fossil sees symbolic links on disk as a separate | |
| 3563 | +** object class that distinct from files and directories. When a symbolic link | |
| 3564 | +** is added to a repository, Fossil stores just the target filename. In other | |
| 3565 | +** words, Fossil stores the link itself, not the object that the link points to. | |
| 3566 | +** | |
| 3567 | +** Symbolic links are not cross-platform. They are not available on all | |
| 3568 | +** operating systems and file systems. Hence the allow-symlinks setting is | |
| 3569 | +** OFF by default, for portability. | |
| 3568 | 3570 | */ |
| 3569 | 3571 | /* |
| 3570 | 3572 | ** SETTING: auto-captcha boolean default=on variable=autocaptcha |
| 3571 | 3573 | ** If enabled, the /login page provides a button that will automatically |
| 3572 | 3574 | ** fill in the captcha password. This makes things easier for human users, |
| 3573 | 3575 |
| --- src/db.c | |
| +++ src/db.c | |
| @@ -3551,22 +3551,24 @@ | |
| 3551 | ** in the "admin_log" table of the repository. |
| 3552 | */ |
| 3553 | /* |
| 3554 | ** SETTING: allow-symlinks boolean default=off sensitive |
| 3555 | ** |
| 3556 | ** When allow-symlinks is OFF (which is the default and recommended setting) |
| 3557 | ** symbolic links a treated like text files that contain a single line of |
| 3558 | ** content which is the name of their target. If allow-symlinks is ON, |
| 3559 | ** the symbolic links are actually followed. |
| 3560 | ** |
| 3561 | ** The use of symbolic links is dangerous. If you checkout a maliciously |
| 3562 | ** crafted checkin that contains symbolic links, it is possible that files |
| 3563 | ** outside of the working directory might be overwritten. |
| 3564 | ** |
| 3565 | ** Keep this setting OFF unless you have a very good reason to turn it |
| 3566 | ** on and you implicitly trust the integrity of the repositories you |
| 3567 | ** open. |
| 3568 | */ |
| 3569 | /* |
| 3570 | ** SETTING: auto-captcha boolean default=on variable=autocaptcha |
| 3571 | ** If enabled, the /login page provides a button that will automatically |
| 3572 | ** fill in the captcha password. This makes things easier for human users, |
| 3573 |
| --- src/db.c | |
| +++ src/db.c | |
| @@ -3551,22 +3551,24 @@ | |
| 3551 | ** in the "admin_log" table of the repository. |
| 3552 | */ |
| 3553 | /* |
| 3554 | ** SETTING: allow-symlinks boolean default=off sensitive |
| 3555 | ** |
| 3556 | ** When allow-symlinks is OFF, Fossil does not see symbolic links on disk as |
| 3557 | ** a separate class of object. Instead Fossil sess the object that the |
| 3558 | ** symbolic link points to. Fossil will only manage with files and directories, |
| 3559 | ** not symbolic links. When a symbolic link is added to a repository, the |
| 3560 | ** object that the link points to is added, not the link itself. |
| 3561 | ** |
| 3562 | ** When allow-symlinks is ON, Fossil sees symbolic links on disk as a separate |
| 3563 | ** object class that distinct from files and directories. When a symbolic link |
| 3564 | ** is added to a repository, Fossil stores just the target filename. In other |
| 3565 | ** words, Fossil stores the link itself, not the object that the link points to. |
| 3566 | ** |
| 3567 | ** Symbolic links are not cross-platform. They are not available on all |
| 3568 | ** operating systems and file systems. Hence the allow-symlinks setting is |
| 3569 | ** OFF by default, for portability. |
| 3570 | */ |
| 3571 | /* |
| 3572 | ** SETTING: auto-captcha boolean default=on variable=autocaptcha |
| 3573 | ** If enabled, the /login page provides a button that will automatically |
| 3574 | ** fill in the captcha password. This makes things easier for human users, |
| 3575 |