[pacman-dev] [PATCH 1/5] pacman-key: keyring management tool
guillaume at alaux.net
Sat Sep 18 17:40:19 EDT 2010
On 18 September 2010 22:05, Guillaume ALAUX <guillaume at alaux.net> wrote:
> On 16 September 2010 17:58, Denis A. Altoé Falqueto
> <denisfalqueto at gmail.com> wrote:
>> On Thu, Sep 16, 2010 at 4:37 AM, Guillaume ALAUX
>> <guillaume at archlinux.org> wrote:
>>> Hi Denis, Hi everyone,
>>> I'm really pleased to see you're back on track.
>> Hi and thanks for the support :)
>>>> If any of the collaborators want to help, this is the time
>>> I would be glad to.
>>> I see you need help to write the man right? Is this the number one
>>> task? Because I could also help with some more technical things if
>>> Just let me know.
>> Yeah, right now the man page for pacman-key is the work that needs to
>> be done. The script is not very complex, but 1) English is not my
>> mother language and 2) I don't have lots of time. My wife is doing an
>> internship and my daughter is consuming almost all my free time. But
>> if you want to start a draft, I can surely help to develop it.
>> If you want to discuss the script itself, you are also welcome. When
>> the developers start to comment on the other patches, you can also
>> help. Or you can start commenting on them right now. Don't be shy :)
>> A: Because it obfuscates the reading.
>> Q: Why is top posting so bad?
>> Denis A. Altoe Falqueto
> Silly question: what is the format for "source man pages" for pacman?
> Pacman man page has a comment saying it was generated by "DocBook XSL
> Stylesheets" but I can't find SGML (nor XML file). Are they plain
> text? AsciiDoc?
Here is a TXT version of the "usage" of pacman-key. Nothing more from
now on but that is a starter. Anyone willing to check my English or
add things is welcome. Footer.txt is the one from pacman/doc folder.
I may dig a bit further into the script to elaborate the man.
As I'm completely new to writing man pages, here is how I get HTML and
man page from this:
Generate HTML from TXT
Generate XML from TXT
asciidoc -b docbook -d manpage pacman-key.8.txt
Generate man from XML
Let me know if that looks useful.
-------------- next part --------------
vim:set ts=4 sw=4 syntax=asciidoc noet:
pacman-key - manage pacman's list of trusted keys
'pacman-key' [options] command [arguments]
The script pacman-key manage pacman's keyring. It imports, exports,
fetches from keyservers, helps in the process of trusting and updates the trust database.
Set an alternative configuration file to use.
Default is /etc/pacman.conf
Set an alternative home directory for GnuPG.
Default is set in /etc/pacman.conf
*-a, \--add [<file>] ...*::
Add the key contained in <file> (empty for stdin)
*-d, \--del <keyid> ...*::
Remove the key <keyid>
*-e, \--export <keyid> ...*::
Output the key <keyid>
*-r, \--receive <keyserver> <keyid> ...*::
Fetch the keyids from the specified keyserver URL
*-t, \--trust <keyid> ...*::
Set the trust level of the given key
Update the trustdb of pacman
Reloads the keys from the keyring package
*-f, \--finger [<keyid]> ...*::
List fingerprint for specified keyids (or for all, if none is specified
Use pacman's keyring as target for advanced commands
Displays this message
Displays the current version
More information about the pacman-dev