From: Liliana Marie Prikler <liliana.prikler@gmail.com>
To: "Ludovic Courtès" <ludo@gnu.org>
Cc: Leo Famulari <leo@famulari.name>,
Maxime Devos <maximedevos@telenet.be>,
54454-done@debbugs.gnu.org
Subject: [bug#54454] [PATCH v2] ui: Describe package outputs.
Date: Fri, 02 Sep 2022 19:14:21 +0200 [thread overview]
Message-ID: <9864efcca48f4c14303e965e2aeb61f7d2264466.camel@gmail.com> (raw)
In-Reply-To: <87k06lu2l7.fsf@gnu.org>
Am Freitag, dem 02.09.2022 um 19:07 +0200 schrieb Ludovic Courtès:
> Hey,
>
> Liliana Marie Prikler <liliana.prikler@gmail.com> skribis:
>
> > Am Sonntag, dem 26.06.2022 um 14:37 +0200 schrieb Liliana Marie
> > Prikler:
> > > * guix/ui.scm (package->recutils): Output outputs with their
> > > descriptions,
> > > one per line.
> > > * po/packages/Makevars (XGETTEXT_OPTIONS): Add ‘output-synopsis’
> > > as
> > > keyword.
> > I pushed this now.
>
> Thanks for moving forward on this!
>
> I get:
>
> --8<---------------cut here---------------start------------->8---
> $ guix show git |head -10
> name: git
> version: 2.37.2
> outputs:
> + send-email: see Appendix H
> + svn: see Appendix H
> + credential-netrc: see Appendix H
> + credential-libsecret: see Appendix H
> + subtree: see Appendix H
> + gui: see Appendix H
> + out: everything else
> --8<---------------cut here---------------end--------------->8---
>
> Where can I see Appendix H though? (Real question.)
There is no appendix H, it's an obscure reference to the appendix H of
the x86 instruction set (containing undocumented instructions or here
undocumented outputs 🙂️).
In order to have a more meaningful string, you'd need to add an output
synopsis property to the package like so:
(properties
`(...
(output-synopsis "send-email" "the `git send-email' command")
(output-synopsis "credential-libsecret" "the libsecret credential
helper")
...))
The second string should (if I got everything right) be translatable
without needing to wrap it in a G_.
Cheers
next prev parent reply other threads:[~2022-09-02 17:15 UTC|newest]
Thread overview: 19+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-03-18 19:16 [bug#54454] [PATCH] ui: Describe package outputs Liliana Marie Prikler
2022-03-18 20:12 ` Maxime Devos
2022-03-18 20:23 ` Liliana Marie Prikler
2022-03-18 20:16 ` Maxime Devos
2022-03-18 20:25 ` Liliana Marie Prikler
2022-03-18 20:50 ` Maxime Devos
2022-03-18 20:54 ` Maxime Devos
2022-03-18 22:24 ` Liliana Marie Prikler
2022-03-18 22:57 ` Maxime Devos
2022-03-18 23:27 ` Liliana Marie Prikler
2022-03-19 8:56 ` Maxime Devos
2022-03-19 10:48 ` Ludovic Courtès
2022-03-19 16:24 ` Leo Famulari
2022-06-26 12:37 ` [bug#54454] [PATCH v2] " Liliana Marie Prikler
2022-08-16 19:37 ` bug#54454: " Liliana Marie Prikler
2022-09-02 17:07 ` [bug#54454] " Ludovic Courtès
2022-09-02 17:14 ` Liliana Marie Prikler [this message]
2022-09-03 9:53 ` zimoun
2022-09-05 7:25 ` Ludovic Courtès
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://guix.gnu.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=9864efcca48f4c14303e965e2aeb61f7d2264466.camel@gmail.com \
--to=liliana.prikler@gmail.com \
--cc=54454-done@debbugs.gnu.org \
--cc=leo@famulari.name \
--cc=ludo@gnu.org \
--cc=maximedevos@telenet.be \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/guix.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).