From 9dde9314e893660fc318271742a25e991ef94451 Mon Sep 17 00:00:00 2001 From: Shun Sakai Date: Thu, 28 May 2020 16:38:20 +0900 Subject: [PATCH] Change to generate man page from AsciiDoc --- INSTALL.md | 1 + README.md | 2 +- docs/CMakeLists.txt | 41 +++-- docs/man/keepassxc-cli.1.adoc | 282 +++++++++++++++++++++++++++++++++ docs/man/keepassxc.1.adoc | 41 +++++ share/docs/man/keepassxc-cli.1 | 274 -------------------------------- share/docs/man/keepassxc.1 | 39 ----- src/CMakeLists.txt | 4 - src/cli/CMakeLists.txt | 4 - 9 files changed, 355 insertions(+), 333 deletions(-) create mode 100644 docs/man/keepassxc-cli.1.adoc create mode 100644 docs/man/keepassxc.1.adoc delete mode 100644 share/docs/man/keepassxc-cli.1 delete mode 100644 share/docs/man/keepassxc.1 diff --git a/INSTALL.md b/INSTALL.md index f452d84dd..2dc933728 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -15,6 +15,7 @@ The following tools must exist within your PATH: * make * cmake (>= 2.8.12) * g++ (>= 4.7) or clang++ (>= 3.0) +* asciidoctor (on Linux/MacOS) The following libraries are required: diff --git a/README.md b/README.md index d5070b8b7..6bd80c94b 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,7 @@ so please check out your distribution's package list to see if KeePassXC is avai - YubiKey challenge-response support - TOTP generation - CSV import -- A [Command Line Interface (keepassxc-cli)](./share/docs/man/keepassxc-cli.1) +- A [Command Line Interface (keepassxc-cli)](./share/docs/man/keepassxc-cli.1.adoc) - DEP and ASLR hardening - Stand-alone password and passphrase generator - Password strength meter diff --git a/docs/CMakeLists.txt b/docs/CMakeLists.txt index 1ac3c5fdc..8a64701cc 100644 --- a/docs/CMakeLists.txt +++ b/docs/CMakeLists.txt @@ -20,27 +20,46 @@ else() message(STATUS "Using asciidoctor: ${ASCIIDOCTOR_EXE}") endif() +set(DOC_DIR ${CMAKE_CURRENT_SOURCE_DIR}) +set(OUT_DIR ${CMAKE_CURRENT_BINARY_DIR}) + # Build html documentation on all platforms add_custom_command(OUTPUT KeePassXC_GettingStarted.html - COMMAND ${ASCIIDOCTOR_EXE} -D ${CMAKE_CURRENT_BINARY_DIR} -o KeePassXC_GettingStarted.html GettingStarted.adoc - DEPENDS topics/* styles/* images/* GettingStarted.adoc - WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} + COMMAND ${ASCIIDOCTOR_EXE} -D ${OUT_DIR} -o KeePassXC_GettingStarted.html ${DOC_DIR}/GettingStarted.adoc + DEPENDS ${DOC_DIR}/topics/* ${DOC_DIR}/styles/* ${DOC_DIR}/images/* ${DOC_DIR}/GettingStarted.adoc VERBATIM) add_custom_command(OUTPUT KeePassXC_UserGuide.html - COMMAND ${ASCIIDOCTOR_EXE} -D ${CMAKE_CURRENT_BINARY_DIR} -o KeePassXC_UserGuide.html UserGuide.adoc - DEPENDS topics/* styles/* images/* UserGuide.adoc + COMMAND ${ASCIIDOCTOR_EXE} -D ${OUT_DIR} -o KeePassXC_UserGuide.html ${DOC_DIR}/UserGuide.adoc + DEPENDS ${DOC_DIR}/topics/* ${DOC_DIR}/styles/* ${DOC_DIR}/images/* ${DOC_DIR}/UserGuide.adoc WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} VERBATIM) add_custom_command(OUTPUT KeePassXC_KeyboardShortcuts.html - COMMAND ${ASCIIDOCTOR_EXE} -D ${CMAKE_CURRENT_BINARY_DIR} -o KeePassXC_KeyboardShortcuts.html topics/KeyboardShortcuts.adoc - DEPENDS topics/KeyboardShortcuts.adoc styles/* - WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} + COMMAND ${ASCIIDOCTOR_EXE} -D ${OUT_DIR} -o KeePassXC_KeyboardShortcuts.html ${DOC_DIR}/topics/KeyboardShortcuts.adoc + DEPENDS ${DOC_DIR}/topics/KeyboardShortcuts.adoc ${DOC_DIR}/styles/* VERBATIM) add_custom_target(docs ALL DEPENDS KeePassXC_GettingStarted.html KeePassXC_UserGuide.html KeePassXC_KeyboardShortcuts.html) install(FILES - ${CMAKE_CURRENT_BINARY_DIR}/KeePassXC_GettingStarted.html - ${CMAKE_CURRENT_BINARY_DIR}/KeePassXC_UserGuide.html - ${CMAKE_CURRENT_BINARY_DIR}/KeePassXC_KeyboardShortcuts.html + ${OUT_DIR}/KeePassXC_GettingStarted.html + ${OUT_DIR}/KeePassXC_UserGuide.html + ${OUT_DIR}/KeePassXC_KeyboardShortcuts.html DESTINATION ${DATA_INSTALL_DIR}/docs) + +# Build Man Pages on Linux and macOS +if(APPLE OR UNIX) + add_custom_command(OUTPUT keepassxc.1 + COMMAND ${ASCIIDOCTOR_EXE} -D ${OUT_DIR} -b manpage ${DOC_DIR}/man/keepassxc.1.adoc + DEPENDS ${DOC_DIR}/man/* + VERBATIM) + add_custom_command(OUTPUT keepassxc-cli.1 + COMMAND ${ASCIIDOCTOR_EXE} -D ${OUT_DIR} -b manpage ${DOC_DIR}/man/keepassxc-cli.1.adoc + DEPENDS ${DOC_DIR}/man/* + VERBATIM) + add_custom_target(manpages ALL DEPENDS keepassxc.1 keepassxc-cli.1) + + install(FILES + ${OUT_DIR}/keepassxc.1 + ${OUT_DIR}/keepassxc-cli.1 + DESTINATION ${CMAKE_INSTALL_MANDIR}/man1/) +endif() diff --git a/docs/man/keepassxc-cli.1.adoc b/docs/man/keepassxc-cli.1.adoc new file mode 100644 index 000000000..13d3ec011 --- /dev/null +++ b/docs/man/keepassxc-cli.1.adoc @@ -0,0 +1,282 @@ += keepassxc-cli(1) +:docdate: 2020-07-05 +:doctype: manpage +:manmanual: General Commands Manual + +== NAME +keepassxc-cli - command line interface for the KeePassXC password manager. + +== SYNOPSIS +*keepassxc-cli* _command_ [_options_] + +== DESCRIPTION +*keepassxc-cli* is the command line interface for the *KeePassXC* password manager. +It provides the ability to query and modify the entries of a KeePass database, directly from the command line. + +== COMMANDS +*add* [_options_] <__database__> <__entry__>:: + Adds a new entry to a database. + A password can be generated (_-g_ option), or a prompt can be displayed to input the password (_-p_ option). + The same password generation options as documented for the generate command can be used when the _-g_ option is set. + +*analyze* [_options_] <__database__>:: + Analyzes passwords in a database for weaknesses. + +*clip* [_options_] <__database__> <__entry__> [_timeout_]:: + Copies an attribute or the current TOTP (if the _-t_ option is specified) of a database entry to the clipboard. + If no attribute name is specified using the _-a_ option, the password is copied. + If multiple entries with the same name exist in different groups, only the attribute for the first one is copied. + For copying the attribute of an entry in a specific group, the group path to the entry should be specified as well, instead of just the name. + Optionally, a timeout in seconds can be specified to automatically clear the clipboard. + +*close*:: + In interactive mode, closes the currently opened database (see _open_). + +*db-create* [_options_] <__database__>:: + Creates a new database with a password and/or a key file. + The key file will be created if the file that is referred to does not exist. + If both the key file and password are empty, no database will be created. + +*db-info* [_options_] <__database__>:: + Show a database's information. + +*diceware* [_options_]:: + Generates a random diceware passphrase. + +*edit* [_options_] <__database__> <__entry__>:: + Edits a database entry. + A password can be generated (_-g_ option), or a prompt can be displayed to input the password (_-p_ option). + The same password generation options as documented for the generate command can be used when the _-g_ option is set. + +*estimate* [_options_] [_password_]:: + Estimates the entropy of a password. + The password to estimate can be provided as a positional argument, or using the standard input. + +*exit*:: + Exits interactive mode. + Synonymous with _quit_. + +*export* [_options_] <__database__>:: + Exports the content of a database to standard output in the specified format (defaults to XML). + +*generate* [_options_]:: + Generates a random password. + +*help* [_command_]:: + Displays a list of available commands, or detailed information about the specified command. + +*import* [_options_] <__xml__> <__database__>:: + Imports the contents of an XML database to the target database. + +*locate* [_options_] <__database__> <__term__>:: + Locates all the entries that match a specific search term in a database. + +*ls* [_options_] <__database__> [_group_]:: + Lists the contents of a group in a database. + If no group is specified, it will default to the root group. + +*merge* [_options_] <__database1__> <__database2__>:: + Merges two databases together. + The first database file is going to be replaced by the result of the merge, for that reason it is advisable to keep a backup of the two database files before attempting a merge. + In the case that both databases make use of the same credentials, the _--same-credentials_ or _-s_ option can be used. + +*mkdir* [_options_] <__database__> <__group__>:: + Adds a new group to a database. + +*mv* [_options_] <__database__> <__entry__> <__group__>:: + Moves an entry to a new group. + +*open* [_options_] <__database__>:: + Opens the given database in a shell-style interactive mode. + This is useful for performing multiple operations on a single database (e.g. _ls_ followed by _show_). + +*quit*:: + Exits interactive mode. + Synonymous with _exit_. + +*rm* [_options_] <__database__> <__entry__>:: + Removes an entry from a database. + If the database has a recycle bin, the entry will be moved there. + If the entry is already in the recycle bin, it will be removed permanently. + +*rmdir* [_options_] <__database__> <__group__>:: + Removes a group from a database. + If the database has a recycle bin, the group will be moved there. + If the group is already in the recycle bin, it will be removed permanently. + +*show* [_options_] <__database__> <__entry__>:: + Shows the title, username, password, URL and notes of a database entry. + Can also show the current TOTP. + Regarding the occurrence of multiple entries with the same name in different groups, everything stated in the _clip_ command section also applies here. + +== OPTIONS +=== General options +*--debug-info*:: + Displays debugging information. + +*-k*, *--key-file* <__path__>:: + Specifies a path to a key file for unlocking the database. + In a merge operation this option, is used to specify the key file path for the first database. + +*--no-password*:: + Deactivates the password key for the database. + +*-y*, *--yubikey* <__slot__>:: + Specifies a yubikey slot for unlocking the database. + In a merge operation this option is used to specify the YubiKey slot for the first database. + +*-q*, *--quiet* <__path__>:: + Silences password prompt and other secondary outputs. + +*-h*, *--help*:: + Displays help information. + +*-v*, *--version*:: + Displays the program version. + +=== Merge options +*-d*, *--dry-run* <__path__>:: + Prints the changes detected by the merge operation without making any changes to the database. + +*--key-file-from* <__path__>:: + Sets the path of the key file for the second database. + +*--no-password-from*:: + Deactivates password key for the database to merge from. + +*--yubikey-from* <__slot__>:: + YubiKey slot for the second database. + +*-s*, *--same-credentials*:: + Uses the same credentials for unlocking both databases. + +=== Add and edit options +The same password generation options as documented for the generate command can be used with those 2 commands when the -g option is set. + +*-u*, *--username* <__username__>:: + Specifies the username of the entry. + +*--url* <__url__>:: + Specifies the URL of the entry. + +*-p*, *--password-prompt*:: + Uses a password prompt for the entry's password. + +*-g*, *--generate*:: + Generates a new password for the entry. + +=== Edit options +*-t*, *--title* <__title__>:: + Specifies the title of the entry. + +=== Estimate options +*-a*, *--advanced*:: + Performs advanced analysis on the password. + +=== Analyze options +*-H*, *--hibp* <__filename__>:: + Checks if any passwords have been publicly leaked, by comparing against the given list of password SHA-1 hashes, which must be in "Have I Been Pwned" format. + Such files are available from https://haveibeenpwned.com/Passwords; + note that they are large, and so this operation typically takes some time (minutes up to an hour or so). + +=== Clip options +*-a*, *--attribute*:: + Copies the specified attribute to the clipboard. + If no attribute is specified, the password attribute is the default. + For example, "_-a_ username" would copy the username to the clipboard. + [Default: password] + +*-t*, *--totp*:: + Copies the current TOTP instead of the specified attribute to the clipboard. + Will report an error if no TOTP is configured for the entry. + +=== Create options +*-k*, *--set-key-file* <__path__>:: + Set the key file for the database. + +*-p*, *--set-password*:: + Set a password for the database. + +*-t*, *--decryption-time* <__time__>:: + Target decryption time in MS for the database. + +=== Show options +*-a*, *--attributes* <__attribute__>...:: + Shows the named attributes. + This option can be specified more than once, with each attribute shown one-per-line in the given order. + If no attributes are specified and _-t_ is not specified, a summary of the default attributes is given. + Protected attributes will be displayed in clear text if specified explicitly by this option. + +*-s*, *--show-protected*:: + Shows the protected attributes in clear text. + +*-t*, *--totp*:: + Also shows the current TOTP, reporting an error if no TOTP is configured for the entry. + +=== Diceware options +*-W*, *--words* <__count__>:: + Sets the desired number of words for the generated passphrase. + [Default: 7] + +*-w*, *--word-list* <__path__>:: + Sets the Path of the wordlist for the diceware generator. + The wordlist must have > 1000 words, otherwise the program will fail. + If the wordlist has < 4000 words a warning will be printed to STDERR. + +=== Export options +*-f*, *--format*:: + Format to use when exporting. + Available choices are xml or csv. + Defaults to xml. + +=== List options +*-R*, *--recursive*:: + Recursively lists the elements of the group. + +*-f*, *--flatten*:: + Flattens the output to single lines. + When this option is enabled, subgroups and subentries will be displayed with a relative group path instead of indentation. + +=== Generate options +*-L*, *--length* <__length__>:: + Sets the desired length for the generated password. + [Default: 16] + +*-l*, *--lower*:: + Uses lowercase characters for the generated password. + [Default: Enabled] + +*-U*, *--upper*:: + Uses uppercase characters for the generated password. + [Default: Enabled] + +*-n*, *--numeric*:: + Uses numbers characters for the generated password. + [Default: Enabled] + +*-s*, *--special*:: + Uses special characters for the generated password. + [Default: Disabled] + +*-e*, *--extended*:: + Uses extended ASCII characters for the generated password. + [Default: Disabled] + +*-x*, *--exclude* <__chars__>:: + Comma-separated list of characters to exclude from the generated password. + None is excluded by default. + +*--exclude-similar*:: + Exclude similar looking characters. + [Default: Disabled] + +*--every-group*:: + Include characters from every selected group. + [Default: Disabled] + +== REPORTING BUGS +Bugs and feature requests can be reported on GitHub at https://github.com/keepassxreboot/keepassxc/issues. + +== AUTHOR +This manual page was originally written by Manolis Agkopian , +and is maintained by the KeePassXC Team . diff --git a/docs/man/keepassxc.1.adoc b/docs/man/keepassxc.1.adoc new file mode 100644 index 000000000..965f7ac46 --- /dev/null +++ b/docs/man/keepassxc.1.adoc @@ -0,0 +1,41 @@ += keepassxc(1) +:docdate: 2020-07-05 +:doctype: manpage +:manmanual: General Commands Manual + +== NAME +keepassxc - password manager + +== SYNOPSIS +*keepassxc* [_options_] [_filename(s)_] + +== DESCRIPTION +*KeePassXC* is a free/open-source password manager or safe which helps you to manage your passwords in a secure way. +The complete database is always encrypted with the industry-standard AES (alias Rijndael) encryption algorithm using a 256 bit key. +KeePassXC uses a database format that is compatible with KeePass Password Safe. +Your wallet works offline and requires no Internet connection. + +== OPTIONS +*-h*, *--help*:: + Displays this help. + +*-v*, *--version*:: + Displays version information. + +*--config* <__config__>:: + Path to a custom config file + +*--keyfile* <__keyfile__>:: + Key file of the database + +*--pw-stdin*:: + Read password of the database from stdin + +*--pw*, *--parent-window* <__handle__>:: + Parent window handle + +*--debug-info*:: + Displays debugging information. + +== AUTHOR +This manual page is maintained by the KeePassXC Team . diff --git a/share/docs/man/keepassxc-cli.1 b/share/docs/man/keepassxc-cli.1 deleted file mode 100644 index bac9a8d37..000000000 --- a/share/docs/man/keepassxc-cli.1 +++ /dev/null @@ -1,274 +0,0 @@ -.TH KEEPASSXC-CLI 1 "Jan 04, 2020" - -.SH NAME -keepassxc-cli \- command line interface for the \fBKeePassXC\fP password manager. - -.SH SYNOPSIS -.B keepassxc-cli -.I command -.B [ -.I options -.B ] - -.SH DESCRIPTION -\fBkeepassxc-cli\fP is the command line interface for the \fBKeePassXC\fP password manager. It provides the ability to query and modify the entries of a KeePass database, directly from the command line. - -.SH COMMANDS - -.IP "\fBadd\fP [options] " -Adds a new entry to a database. A password can be generated (\fI-g\fP option), or a prompt can be displayed to input the password (\fI-p\fP option). -The same password generation options as documented for the generate command can be used when the \fI-g\fP option is set. - -.IP "\fBanalyze\fP [options] " -Analyzes passwords in a database for weaknesses. - -.IP "\fBclip\fP [options] [timeout]" -Copies an attribute or the current TOTP (if the \fI-t\fP option is specified) of a database entry to the clipboard. If no attribute name is specified using the \fI-a\fP option, the password is copied. If multiple entries with the same name exist in different groups, only the attribute for the first one is copied. For copying the attribute of an entry in a specific group, the group path to the entry should be specified as well, instead of just the name. Optionally, a timeout in seconds can be specified to automatically clear the clipboard. - -.IP "\fBclose\fP" -In interactive mode, closes the currently opened database (see \fIopen\fP). - -.IP "\fBdb-create\fP [options] " -Creates a new database with a password and/or a key file. The key file will be created if the file that is referred to does not exist. If both the key file and password are empty, no database will be created. - -.IP "\fBdb-info\fP [options] " -Show a database's information. - -.IP "\fBdiceware\fP [options]" -Generates a random diceware passphrase. - -.IP "\fBedit\fP [options] " -Edits a database entry. A password can be generated (\fI-g\fP option), or a prompt can be displayed to input the password (\fI-p\fP option). -The same password generation options as documented for the generate command can be used when the \fI-g\fP option is set. - -.IP "\fBestimate\fP [options] [password]" -Estimates the entropy of a password. The password to estimate can be provided as a positional argument, or using the standard input. - -.IP "\fBexit\fP" -Exits interactive mode. Synonymous with \fIquit\fP. - -.IP "\fBexport\fP [options] " -Exports the content of a database to standard output in the specified format (defaults to XML). - -.IP "\fBgenerate\fP [options]" -Generates a random password. - -.IP "\fBhelp\fP [command]" -Displays a list of available commands, or detailed information about the specified command. - -.IP "\fBimport\fP [options] " -Imports the contents of an XML database to the target database. - -.IP "\fBlocate\fP [options] " -Locates all the entries that match a specific search term in a database. - -.IP "\fBls\fP [options] [group]" -Lists the contents of a group in a database. If no group is specified, it will default to the root group. - -.IP "\fBmerge\fP [options] " -Merges two databases together. The first database file is going to be replaced by the result of the merge, for that reason it is advisable to keep a backup of the two database files before attempting a merge. In the case that both databases make use of the same credentials, the \fI--same-credentials\fP or \fI-s\fP option can be used. - -.IP "\fBmkdir\fP [options] " -Adds a new group to a database. - -.IP "\fBmv\fP [options] " -Moves an entry to a new group. - -.IP "\fBopen\fP [options] " -Opens the given database in a shell-style interactive mode. This is useful for performing multiple operations on a single database (e.g. \fIls\fP followed by \fIshow\fP). - -.IP "\fBquit\fP" -Exits interactive mode. Synonymous with \fIexit\fP. - -.IP "\fBrm\fP [options] " -Removes an entry from a database. If the database has a recycle bin, the entry will be moved there. If the entry is already in the recycle bin, it will be removed permanently. - -.IP "\fBrmdir\fP [options] " -Removes a group from a database. If the database has a recycle bin, the group will be moved there. If the group is already in the recycle bin, it will be removed permanently. - -.IP "\fBshow\fP [options] " -Shows the title, username, password, URL and notes of a database entry. Can also show the current TOTP. Regarding the occurrence of multiple entries with the same name in different groups, everything stated in the \fIclip\fP command section also applies here. - -.SH OPTIONS - -.SS "General options" - -.IP "\fB--debug-info\fP" -Displays debugging information. - -.IP "\fB-k\fP, \fB--key-file\fP " -Specifies a path to a key file for unlocking the database. In a merge operation this option, is used to specify the key file path for the first database. - -.IP "\fB--no-password\fP" -Deactivates the password key for the database. - -.IP "\fB-y\fP, \fB--yubikey\fP " -Specifies a yubikey slot for unlocking the database. In a merge operation this option is used to specify the yubikey slot for the first database. - -.IP "\fB-q\fP, \fB--quiet\fP " -Silences password prompt and other secondary outputs. - -.IP "\fB-h\fP, \fB--help\fP" -Displays help information. - -.IP "\fB-v\fP, \fB--version\fP" -Displays the program version. - - -.SS "Merge options" - -.IP "\fB-d\fP, \fB--dry-run\fP " -Prints the changes detected by the merge operation without making any changes to the database. - -.IP "\fB--key-file-from\fP " -Sets the path of the key file for the second database. - -.IP "\fB--no-password-from\fP" -Deactivates password key for the database to merge from. - -.IP "\fB--yubikey-from\fP " -Yubikey slot for the second database. - -.IP "\fB-s\fP, \fB--same-credentials\fP" -Uses the same credentials for unlocking both databases. - - -.SS "Add and edit options" -The same password generation options as documented for the generate command can be used -with those 2 commands when the -g option is set. - -.IP "\fB-u\fP, \fB--username\fP " -Specifies the username of the entry. - -.IP "\fB--url\fP " -Specifies the URL of the entry. - -.IP "\fB-p\fP, \fB--password-prompt\fP" -Uses a password prompt for the entry's password. - -.IP "\fB-g\fP, \fB--generate\fP" -Generates a new password for the entry. - - -.SS "Edit options" - -.IP "\fB-t\fP, \fB--title\fP " -Specifies the title of the entry. - - -.SS "Estimate options" - -.IP "\fB-a\fP, \fB--advanced\fP" -Performs advanced analysis on the password. - - -.SS "Analyze options" - -.IP "\fB-H\fP, \fB--hibp\fP <filename>" -Checks if any passwords have been publicly leaked, by comparing against the given -list of password SHA-1 hashes, which must be in "Have I Been Pwned" format. Such -files are available from https://haveibeenpwned.com/Passwords; note that they -are large, and so this operation typically takes some time (minutes up to an -hour or so). - - -.SS "Clip options" - -.IP "\fB-a\fP, \fB--attribute\fP" -Copies the specified attribute to the clipboard. If no attribute is specified, -the password attribute is the default. For example, "\fI-a\fP username" would -copy the username to the clipboard. [Default: password] - -.IP "\fB-t\fP, \fB--totp\fP" -Copies the current TOTP instead of the specified attribute to the clipboard. -Will report an error if no TOTP is configured for the entry. - -.SS "Create options" - -.IP "\fB-k\fP, \fB--set-key-file\fP <path>" -Set the key file for the database. - -.IP "\fB-p\fP, \fB--set-password\fP" -Set a password for the database. - -.IP "\fB-t\fP, \fB--decryption-time\fP <time>" -Target decryption time in MS for the database. - - -.SS "Show options" - -.IP "\fB-a\fP, \fB--attributes\fP <attribute>..." -Shows the named attributes. This option can be specified more than once, -with each attribute shown one-per-line in the given order. If no attributes are -specified and \fI-t\fP is not specified, a summary of the default attributes is given. -Protected attributes will be displayed in clear text if specified explicitly by this option. - -.IP "\fB-s\fP, \fB--show-protected\fP" -Shows the protected attributes in clear text. - -.IP "\fB-t\fP, \fB--totp\fP" -Also shows the current TOTP, reporting an error if no TOTP is configured for -the entry. - - -.SS "Diceware options" - -.IP "\fB-W\fP, \fB--words\fP <count>" -Sets the desired number of words for the generated passphrase. [Default: 7] - -.IP "\fB-w\fP, \fB--word-list\fP <path>" -Sets the Path of the wordlist for the diceware generator. The wordlist must -have > 1000 words, otherwise the program will fail. If the wordlist has < 4000 -words a warning will be printed to STDERR. - - -.SS "Export options" - -.IP "\fB-f\fP, \fB--format\fP" -Format to use when exporting. Available choices are xml or csv. Defaults to xml. - - -.SS "List options" - -.IP "\fB-R\fP, \fB--recursive\fP" -Recursively lists the elements of the group. - -.IP "\fB-f\fP, \fB--flatten\fP" -Flattens the output to single lines. When this option is enabled, subgroups and subentries will be displayed with a relative group path instead of indentation. - -.SS "Generate options" - -.IP "\fB-L\fP, \fB--length\fP <length>" -Sets the desired length for the generated password. [Default: 16] - -.IP "\fB-l\fP, \fB--lower\fP" -Uses lowercase characters for the generated password. [Default: Enabled] - -.IP "\fB-U\fP, \fB--upper\fP" -Uses uppercase characters for the generated password. [Default: Enabled] - -.IP "\fB-n\fP, \fB--numeric\fP" -Uses numbers characters for the generated password. [Default: Enabled] - -.IP "\fB-s\fP, \fB--special\fP" -Uses special characters for the generated password. [Default: Disabled] - -.IP "\fB-e\fP, \fB--extended\fP" -Uses extended ASCII characters for the generated password. [Default: Disabled] - -.IP "\fB-x\fP, \fB--exclude\fP <chars>" -Comma-separated list of characters to exclude from the generated password. None is excluded by default. - -.IP "\fB--exclude-similar\fP" -Exclude similar looking characters. [Default: Disabled] - -.IP "\fB--every-group\fP" -Include characters from every selected group. [Default: Disabled] - - -.SH REPORTING BUGS -Bugs and feature requests can be reported on GitHub at https://github.com/keepassxreboot/keepassxc/issues. - -.SH AUTHOR -This manual page was originally written by Manolis Agkopian <m.agkopian@gmail.com>, -and is maintained by the KeePassXC Team <team@keepassxc.org>. diff --git a/share/docs/man/keepassxc.1 b/share/docs/man/keepassxc.1 deleted file mode 100644 index fd2bbced4..000000000 --- a/share/docs/man/keepassxc.1 +++ /dev/null @@ -1,39 +0,0 @@ -.TH KEEPASSXC 1 "Oct 25, 2019" -.SH NAME -keepassxc \- password manager - -.SH SYNOPSIS -.B keepassxc -.B [ -.I options -.B ] [ -.I filename(s) -.B ] - -.SH DESCRIPTION -\fBKeePassXC\fP is a free/open-source password manager or safe which helps you to manage your passwords in a secure way. The complete database is always encrypted with the industry-standard AES (alias Rijndael) encryption algorithm using a 256 bit key. KeePassXC uses a database format that is compatible with KeePass Password Safe. Your wallet works offline and requires no Internet connection. - -.SH OPTIONS -.IP "\fB-h\fP, \fB--help\fP" -Displays this help. - -.IP "\fB-v\fP, \fB--version\fP" -Displays version information. - -.IP "\fB--config\fP <config>" -Path to a custom config file - -.IP "\fB--keyfile\fP <keyfile>" -Key file of the database - -.IP "\fB--pw-stdin\fP" -Read password of the database from stdin - -.IP "\fB--pw\fP, \fB--parent-window\fP <handle>" -Parent window handle - -.IP "\fB--debug-info\fP" -Displays debugging information. - -.SH AUTHOR -This manual page is maintained by the KeePassXC Team <team@keepassxc.org>. diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt index 9aa586770..2f8c3b156 100644 --- a/src/CMakeLists.txt +++ b/src/CMakeLists.txt @@ -419,10 +419,6 @@ install(TARGETS ${PROGNAME} BUNDLE DESTINATION . COMPONENT Runtime RUNTIME DESTINATION ${BIN_INSTALL_DIR} COMPONENT Runtime) -if(APPLE OR UNIX) - install(FILES ../share/docs/man/keepassxc.1 DESTINATION ${CMAKE_INSTALL_MANDIR}/man1/) -endif() - if(MINGW) if(${CMAKE_SIZEOF_VOID_P} EQUAL "8") set(OUTPUT_FILE_POSTFIX "Win64") diff --git a/src/cli/CMakeLists.txt b/src/cli/CMakeLists.txt index 2bce90f88..f49ef9e9c 100644 --- a/src/cli/CMakeLists.txt +++ b/src/cli/CMakeLists.txt @@ -118,7 +118,3 @@ if(APPLE AND WITH_APP_BUNDLE) COMMAND ${CMAKE_COMMAND} -E copy keepassxc-cli ${CLI_APP_DIR}/keepassxc-cli COMMENT "Copying keepassxc-cli inside the application") endif() - -if(APPLE OR UNIX) - install(FILES ../../share/docs/man/keepassxc-cli.1 DESTINATION ${CMAKE_INSTALL_MANDIR}/man1/) -endif()