Man page website

[Pete Travis]

On Tue, Jul 31, 2012 at 11:51 AM, Christopher Antila <
crantila at fedoraproject.org> wrote:

> On 30 July 2012 10:16:04 Eric "Sparks" Christensen wrote:
> > A few weeks ago we received a ticket[0] asking about publishing man
> > pages for Fedora on the Internet.  We know that there are other man
> > pages out there however we have found that they may not be up to date
> > with the versions that are in Fedora.
> >
> > The overall opinion, that I've seen, is that this would be something
> > that might be worthwhile *if* we can script the entire process.
> >
> > Does anyone have any ideas for doing this or have any opinions on
> > doing this?
> >
> >
> > [0] https://bugzilla.redhat.com/show_bug.cgi?id=828669
> >
> > -- Eric
> >
> >
> > =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
> > Fedora Project  -  https://fedoraproject.org
> >
> > Member of:
> >    * Fedora Board
> >    * Documentation Project
> >
> > 097C 82C3 52DF C64A 50C2  E3A3 8076 ABDE 024B B3D1
> > =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
>
> Hi:
>
> For the ground-breaking kind of effort this would take, I think it's a
> waste of
> time. We'd be better off spending this effort on improving our
> pre-existing,
> user-oriented documentation. The fact is, only a very small percentage of
> the
> population uses manual pages and there isn't much advantage for them to be
> accessible in a web browser.
>
> We need to think about our distribution's target user base. If you're
> looking
> up a manual page, you're using a terminal emulator, and you should be
> comfortable enough to know how to use the up-arrow, down-arrow, and 'q'
> buttons on your keyboard. In other words, I think the advantage of
> web-based
> manual pages is negligible.
>
> But...
> If we do put them online, we should not say "man" anywhere, if possible.
>
> But...
> If we can localize the manual pages *and* send the translations upstream,
> then
> maybe it's worth it.
>
>
If we wanted to go forward looking at the packages app, is there a way for
us to look its implementation? I see it uses moshka, but the keywords I
tossed at http://git.fedorahosted.org/cgit/ didn't find anything.

I like the idea of pushing translated manpages upstream. Does `man` itself
have localization features?

--pete
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20120731/a7175574/attachment.html>