Mailinglist Archive: opensuse-factory (341 mails)

["Carlos E. R." <robin.listas@xxxxxxxxxxxxxx>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1



On Monday, 2009-02-09 at 17:32 +0100, anicka@xxxxxxx wrote:

> Czech Packagers Meeting minutes 2009-02-03
...
> (1) Missing Manpages
> ====================
>
> As an internal discussion shows, most of the developers generally agree that
> policy of having manpage for every executable would bring us benefits. There
> are several different ways how to do it: We could profit on the fact that
> Debian has similar policy for ages and their manpages are usually written in a
> very good quality. But we would have to find a way how to keep our different
> versions of packages in sync with these manpages. We could also generate very
> simple manpages containing just a link to the proper documention using ie.
> help2man.
>
> We think that as for packages with upstream reluctant to take care for
> manpages, common repository for all the distributors would be a great help.
>
> And of course, executables might be just a first step - it would be very
> convenient to have a manpage containing useful information for every config
> file, or, especially, for every init script.

You could consider whether translating manpages is interesting or not. Many 
pages are not translated, or the translation is obsolete and wrong.

As a translator, I can tell you that it is quite difficult (for me) to 
translate a manpage, because there is no useful manpage writing program - 
ie, one that does not require the writer to be a programmer.

- -- 
Cheers,
       Carlos E. R.

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.9 (GNU/Linux)

iEYEARECAAYFAkmU2rgACgkQtTMYHG2NR9WfPACggpytJJSdK+JkMn8fXVUQfmCC
P3QAniaiv2gO/1mi29s6MM3EBVuT9Tdv
=BdvW
-----END PGP SIGNATURE-----
--
To unsubscribe, e-mail: opensuse-factory+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-factory+help@xxxxxxxxxxxx