Product: Fedora
https://bugzilla.redhat.com/show_bug.cgi?id=890859
--- Comment #18 from Antonio Trande <trpost(a)katamail.com> ---
(In reply to comment #16)
There is just this, linked from the ReviewGuidelines page:
| SHOULD: your package should contain man pages for binaries/scripts.
| If it doesn't, work with upstream to add them where they make sense.
| [32]
It's a SHOULD, not a MUST, and the "where they make sense" is worth
noting,
too. The guidelines are weak at trying to answer the _why_ or _when_:
| [32]
http://fedoraproject.org/wiki/Packaging/Guidelines#Man_pages
|
| Man pages are the traditional method of getting help on a unix system.
| Packages should contain man pages for all binaries/scripts. If it doesn't,
| work with upstream to add them. Sometimes, other distributions (notably
| Debian), have man pages for programs. You can use those as a starting
point.
Does /usr/bin/scopy take any command-line options at all? Else the man page
might only mention few details, such as Author, Copyright/License and a
brief description of what the program does. Perhaps a pointer at the HTML
documentation and a hint that it is nothing like "scp". *grin* If
"better
than nothing" is the only goal, someone may call such a manual "helpful".
I
find it very unimportant. Sure, "man scopy" and "man 6 scopy" would
work
then, but if it were not available, that wouldn't be a big loss for a
completely optional game package.
Hi Michael.
Thank you again for your availability.
I don't know how much this game is known out of Italy; this is main reason
because I thought to translate in English its documentation.
The knowledge of this game and of its rules is fundamental to know how it
works.
IMO, a manual page for a game with a graphical user-interface, with
documentation in HTML, and with RPM package details (description, license,
URL, to name a few) doesn't make much sense.
Translating the Italian documentation into English could be a more useful
contribution to the Scopy project.
This could be another valid option.
I'm waiting to know how upstream evaluates all that. :)
--
You are receiving this mail because:
You are on the CC list for the bug.
Unsubscribe from this bug
https://bugzilla.redhat.com/token.cgi?t=sGnWwhy2xx&a=cc_unsubscribe