<br><br><div class="gmail_quote">On Tue, Jul 31, 2012 at 11:51 AM, Christopher Antila <span dir="ltr"><<a href="mailto:crantila@fedoraproject.org" target="_blank">crantila@fedoraproject.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="im">On 30 July 2012 10:16:04 Eric "Sparks" Christensen wrote:<br>
> A few weeks ago we received a ticket[0] asking about publishing man<br>
> pages for Fedora on the Internet. We know that there are other man<br>
> pages out there however we have found that they may not be up to date<br>
> with the versions that are in Fedora.<br>
><br>
> The overall opinion, that I've seen, is that this would be something<br>
> that might be worthwhile *if* we can script the entire process.<br>
><br>
> Does anyone have any ideas for doing this or have any opinions on<br>
> doing this?<br>
><br>
><br>
> [0] <a href="https://bugzilla.redhat.com/show_bug.cgi?id=828669" target="_blank">https://bugzilla.redhat.com/show_bug.cgi?id=828669</a><br>
><br>
</div><div class="im">> -- Eric<br>
><br>
><br>
> =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=<br>
> Fedora Project - <a href="https://fedoraproject.org" target="_blank">https://fedoraproject.org</a><br>
><br>
> Member of:<br>
> * Fedora Board<br>
> * Documentation Project<br>
><br>
> 097C 82C3 52DF C64A 50C2 E3A3 8076 ABDE 024B B3D1<br>
> =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=<br>
<br>
</div>Hi:<br>
<br>
For the ground-breaking kind of effort this would take, I think it's a waste of<br>
time. We'd be better off spending this effort on improving our pre-existing,<br>
user-oriented documentation. The fact is, only a very small percentage of the<br>
population uses manual pages and there isn't much advantage for them to be<br>
accessible in a web browser.<br>
<br>
We need to think about our distribution's target user base. If you're looking<br>
up a manual page, you're using a terminal emulator, and you should be<br>
comfortable enough to know how to use the up-arrow, down-arrow, and 'q'<br>
buttons on your keyboard. In other words, I think the advantage of web-based<br>
manual pages is negligible.<br>
<br>
But...<br>
If we do put them online, we should not say "man" anywhere, if possible.<br>
<br>
But...<br>
If we can localize the manual pages *and* send the translations upstream, then<br>
maybe it's worth it.<br>
<span class="HOEnZb"><font color="#888888">
<br></font></span></blockquote><div><br></div><div>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 <a href="http://git.fedorahosted.org/cgit/">http://git.fedorahosted.org/cgit/</a> didn't find anything. </div>
<div><br></div><div>I like the idea of pushing translated manpages upstream. Does `man` itself have localization features?</div><div><br></div><div>--pete </div></div><br>