pkg.conf(5) BACKUP_LIBRARIES, BACKUP_LIBRARY_PATH #2440
Conversation
Punctuation; uppercase beginnings to sentences; and 'define by' should be 'defined by'. Whilst here, aim to make the section a little clearer.
The section for BACKUP_LIBRARIES uses the word 'path'. Consistency: the same word may be used here.
Clarity: 'backup the library to' is less ambiguous than 'backup the library at'.
| .Qq compat-libraries | ||
| will be created. the version will be bumped each time a new library is backed up | ||
| package. The package version will be bumped whenever an additional library is backed up. |
There was a problem hiding this comment.
| package. The package version will be bumped whenever an additional library is backed up. | |
| package. The package version will increase whenever an additional library is backed up. |
Avoiding the word bump, because it seems not well-suited to changes such as 20250322165541 up to 20250325164747.
There was a problem hiding this comment.
No, the way you have it in the patch currently is an improvement.
| .Qq compat-libraries | ||
| will be created. the version will be bumped each time a new library is backed up | ||
| package. The package version will be bumped whenever an additional library is backed up. | ||
| Default: NO. |
There was a problem hiding this comment.
| Default: NO. | |
| Default: false. |
Boolean pairings:
trueorfalseYESorNO
– true or NO sounds a little strange.
There was a problem hiding this comment.
No. The whole page uses "YES" and "NO" consistently.
| .Qq compat-libraries | ||
| will be created. the version will be bumped each time a new library is backed up | ||
| package. The package version will be bumped whenever an additional library is backed up. |
There was a problem hiding this comment.
No, the way you have it in the patch currently is an improvement.
| .Qq compat-libraries | ||
| will be created. the version will be bumped each time a new library is backed up | ||
| package. The package version will be bumped whenever an additional library is backed up. | ||
| Default: NO. |
There was a problem hiding this comment.
No. The whole page uses "YES" and "NO" consistently.
| .Qq compat-libraries | ||
| will be created. the version will be bumped each time a new library is backed up | ||
| package. The package version will be bumped whenever an additional library is backed up. |
There was a problem hiding this comment.
| package. The package version will be bumped whenever an additional library is backed up. | |
| package. | |
| The package version will be bumped whenever an additional library is | |
| backed up. |
Sorry to backtrack, I forgot something! Roff requires one sentence per line, and please wrap at 72 for compatibility with standardized methodology and tooling in base. After that, LGTM!
Minor corrections:
Whilst here, aim to make the sections a little clearer and more consistent.