digiKam handbook migrated from DocBook to Sphinx/ReStructuredText
Hi all translation team, I'm glad to announce that the whole digiKam handbook based on DocBook format is not fully migrated to the Sphinx/RestructuredText framework. This will help to maintain the manual more easily in time, as ReStructuredText is so far better in all forms than the DocBook format, especially for huge documentation. The infrastructure is based on the KDenLive works (based too on the Krita works). For the translations of this manual, it will be the same workflow. Online manual is hosted in a dedicated web site available here : https://docs.digikam.org/en/index.html This means that older Docbook translations from the older manual are now obsolete... Typically the obsolete POT files are there (docbook): https://websvn.kde.org/trunk/l10n-kf5/templates/docmessages/digikam-doc/ The new POT files are there (ReStructuredText): https://websvn.kde.org/trunk/l10n-kf5/templates/messages/digikam-doc/ The git repository for the new manual still the same than previous one : https://invent.kde.org/documentation/digikam-doc Look at the README file for details. Thanks to contribute and all the best for this new year Gilles Caulier
[network/smb4k] doc: Update handbook.
Git commit a093c6776fd9459e8dc42d25309db0e39985b467 by Alexander Reinholdt. Committed on 29/12/2022 at 07:08. Pushed by areinholdt into branch 'master'. Update handbook. M +35 -28 doc/index.docbook https://invent.kde.org/network/smb4k/commit/a093c6776fd9459e8dc42d25309db0e39985b467 diff --git a/doc/index.docbook b/doc/index.docbook index c84e651e..714e5f6a 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -3320,7 +3320,7 @@ ntlm auth = yes Option: -a/--archive, same as -rlptgoD (no -A, -X, -U, -N, -H) - Switch the archive mode on. This is a quick way of saying you want recursion and want to preserve almost everything. Note that -a does not preserve hardlinks (-H), access control lists (ACLs, -A), extended attributes (xattrs, -X), access (use) times (-U) nor crtimes (-N). You must separately specify these options. The only exception to the above equivalence is when --files-from is specified, in which case -r is not implied. + Switch the archive mode on. This is a quick way of saying you want recursion and want to preserve almost everything. Note that -a does not preserve hardlinks (-H), access control lists (ACLs, -A), extended attributes (xattrs, -X), access (use) times (-U) nor create times (-N). You must separately specify these options. The only exception to the above equivalence is when --files-from is specified, in which case -r is not implied. In case you do not want to run rsync in archive mode, choose the appropriate arguments in the settings yourself. Default: selected @@ -3370,8 +3370,7 @@ ntlm auth = yes -Backup - +Backups @@ -3574,10 +3573,12 @@ ntlm auth = yes + - -Permissions, - + + File Attributes Ownership + +File Attributes @@ -3631,51 +3632,57 @@ ntlm auth = yes - Preserve owner + Preserve device and special files - Option: -o/--owner - This option causes rsync1 to set the owner of the destination file to be the same as the one of the source file. By default, the preservation is done by name, but may fall back to using the ID number in some circumstances (see the --numeric-ids option for a full discussion). This option has no effect if the receiving rsync1 is not run as the super user and --super is not specified. + Option: -D/--devices --specials + This option causes rsync1 to transfer character and block device files as well as special files (such as named sockets and fifos) to the remote system. This option has no effect if the receiving side is not run as the super user and --super is not specified. Default: not selected - Preserve group + Preserve times - Option: -g/--group - This option causes rsync1 to set the group of the destination file to be the same as the on of the source file. If the receiving program is not running as the super-user (or with the --no-super option), only groups that the receiver is a member of will be preserved. + Option: -t/--times + This tells rsync1 to transfer modification times along with the files and update them on the remote system. Default: not selected - Preserve device and special files + Omit directories when preserving times - Option: -D/--devices --specials - This option causes rsync1 to transfer character and block device files as well as special files (such as named sockets and fifos) to the remote system. This option has no effect if the receiving side is not run as the super user and --super is not specified. + Option: -O/--omit-dir-times + This tells rsync1 to omit directories when it is preserving modification times (see --times). Default: not selected + + + + +Ownership + - Preserve times + Preserve owner - Option: -t/--times - This tells rsync1 to transfer modification times along with the files and update them on the remote system. + Option: -o/--owner + This option causes rsync1 to set the owner of the destination file to be the same as the one of the source file. By default, the preservation is done by name, but may fall back to using the ID number in some circumstances (see the
[network/smb4k] doc: Updated handbook.
Git commit 9c0d9d480fcd1a502c6f9139e2659a729bbb119c by Alexander Reinholdt. Committed on 28/12/2022 at 18:02. Pushed by areinholdt into branch 'master'. Updated handbook. M +47 -7doc/index.docbook https://invent.kde.org/network/smb4k/commit/9c0d9d480fcd1a502c6f9139e2659a729bbb119c diff --git a/doc/index.docbook b/doc/index.docbook index 17be5416..c84e651e 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -3320,7 +3320,7 @@ ntlm auth = yes Option: -a/--archive, same as -rlptgoD (no -A, -X, -U, -N, -H) - Switch the archive mode on. This is a quick way of saying you want recursion and want to preserve almost everything. Note that -a does not preserve hardlinks, because finding multiply-linked files is expensive. You must separately specify -H. + Switch the archive mode on. This is a quick way of saying you want recursion and want to preserve almost everything. Note that -a does not preserve hardlinks (-H), access control lists (ACLs, -A), extended attributes (xattrs, -X), access (use) times (-U) nor crtimes (-N). You must separately specify these options. The only exception to the above equivalence is when --files-from is specified, in which case -r is not implied. In case you do not want to run rsync in archive mode, choose the appropriate arguments in the settings yourself. Default: selected @@ -3498,7 +3498,7 @@ ntlm auth = yes Option: -l/--links Copy symlinks as symlinks. - Default: selected + Default: not selected @@ -3586,7 +3586,47 @@ ntlm auth = yes Option: -p/--perms This option causes the receiving side to set the destination permissions to be the same as the source permissions. - Default: selected + Default: not selected + + + + + Preserve access control lists (ACLs) + + + Option: -A/--acls + Preserve access control lists. This option causes rsync to update the destination ACLs to be the same as the source ACLs. The option also implies --perms. The source and destination systems must have compatible ACL entries for this option to work properly. + Default: not selected + + + + + Preserve extended attributes + + + Option: -X/--xattrs + Preserve extended attributes. This option causes rsync to update the destination extended attributes to be the same as the source ones. + Default: not selected + + + + + Preserve access times + + + Option: -U/--atimes + Preserve access times. This tells rsync to set the access (use) times of the destination files to the same value as the source files. + Default: not selected + + + + + Preserve create times + + + Option: -N/--crtimes + Preserve create times. This tells rsync to set the create times (newness) of the destination files to the same value as the source files. + Default: not selected @@ -3596,7 +3636,7 @@ ntlm auth = yes Option: -o/--owner This option causes rsync1 to set the owner of the destination file to be the same as the one of the source file. By default, the preservation is done by name, but may fall back to using the ID number in some circumstances (see the --numeric-ids option for a full discussion). This option has no effect if the receiving rsync1 is not run as the super user and --super is not specified. - Default: selected + Default: not selected @@ -3606,7 +3646,7 @@ ntlm auth = yes Option: -g/--group This option causes rsync1 to set the group of the destination file to be the same as the on of the source file. If the receiving program is not running as the super-user (or with the --no-super option), only groups that the receiver is a member of will be preserved. - Default: selected + Default: not selected @@ -3616,7 +3656,7 @@ ntlm auth = yes Option: -D/--devices --specials This option causes rsync1 to transfer character and block device files as well as special files (such as named sockets and fifos) to the remote system. This option has no effect if the receiving side is not run as the super user and --super is not specified.
Re: Technical Writing / Updating Documentation
On Tuesday, December 27, 2022 2:02:26 PM CST Aaron L wrote:
> I updated my computer running KDE today and noticed under the help
> application the following:
>
> Multiple instances of Discover (showing it multiple times)
I have an instance of Kubuntu on my hard disk. The stock version showed four
copies of "Discover" in the Application Manuals --> System menu. I tracked
this down, and corrected it by editing 3 .desktop files.
In /usr/share/applications/{org.kde.discover.desktop,
org.kde.discover.snap.desktop, org.kde.discover.urlhandler.desktop}
Remove the line "X-DocPath=plasma-discover/index.html" from all three files.
After doing this, "Discover" only shows up once in Application Manuals -->
System.
Notice that the help file /usr/share/doc/plasma-discover/index.html does not
exist on my instance of Kubuntu. I poked around the KDE Gitlab and found the
Discover project, but there aren't any docbook files. So I guess the
documentation for Discover has never been written. I'm not real sure how the
.desktop files are generated; I only noticed one such file in the Gitlab repo.
--
David Bryant
Canyon Lake, Texas
https://davidcbryant.net
signature.asc
Description: This is a digitally signed message part.
