Bug 800234 - man page out of date
Summary: man page out of date
Keywords:
Status: CLOSED RAWHIDE
Alias: None
Product: Fedora
Classification: Fedora
Component: firefox
Version: rawhide
Hardware: All
OS: Linux
unspecified
low
Target Milestone: ---
Assignee: Martin Stransky
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-03-06 04:45 UTC by Steve
Modified: 2012-11-23 02:00 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-10-30 14:31:03 UTC
Type: ---


Attachments (Terms of Use)
firefox man page from Ubuntu-Studio 12.04 (943 bytes, application/x-gzip)
2012-04-28 13:59 UTC, Steve
no flags Details

Description Steve 2012-03-06 04:45:16 UTC
Description of problem:
man page out of date
lists firefox date August 07, 2001    

Version-Release number of selected component (if applicable):
not applicable

How reproducible:
always

Steps to Reproduce:
1. man firefox 
 
Actual results:
man page date August 07, 2001

Expected results:
man page relevant to current version
option -no-remote not listed

Comment 1 Steve 2012-03-06 04:47:36 UTC
open a Mint-12 system
man firefox shows date of 2011-02-09

Comment 2 Jan Horak 2012-04-05 08:46:19 UTC
Thanks for you report. Could you please attach updated manual page?

Comment 3 Steve 2012-04-28 13:59:23 UTC
Created attachment 580971 [details]
firefox man page from Ubuntu-Studio 12.04

Comment 4 Sergio 2012-10-05 02:59:09 UTC
firefox --help : http://paste.org/55041
man firefox : http://paste.org/55043

Maybe tomorrow I try to update the man page and post here (if anyone doesn't do it before).

Comment 5 Sergio 2012-10-05 14:16:18 UTC
Here's the updated man page: http://paste.org/55060

Comment 6 Sergio 2012-10-11 12:26:55 UTC
Hi guys, shipping an outdated man page is misleading. Once I had trouble with Firefox and kept wondering why it had dropped the safe-mode option because it wasn't in the man page (and since there was a man page I never thought of trying 'firefox -h').
So either use the updated man page or maybe even better for maintenance is to do like with Thunderbird and don't ship any man page at all.

Comment 7 Martin Stransky 2012-10-11 21:28:54 UTC
Thanks. But I'm not sure we can just ship a manpage which is copied from Ubuntu. Which license does the Ubuntu man page have?

Comment 8 Sergio 2012-10-11 22:08:36 UTC
That updated man page (comment #5) I did myself, with some help of help2man.

Comment 9 Sergio 2012-10-11 22:18:53 UTC
http://paste.org/55367
Fixed a little thing (replaced 'Print this message' for 'Print all command-line options').

Comment 10 Martin Stransky 2012-10-12 06:48:42 UTC
Great, Thanks! 

Could you please include other common sections like VERSION, SEE ALSO, AUTHORS? You may also state that you created the man page but I'm not sure where it's supposed to be placed.

As for the SEE ALSO section, if you create a man page for other products (thunderbird, xulrunner, seamonkey?) we'll update those man pages too.

Thanks again!

Comment 11 Sergio 2012-10-12 10:34:29 UTC
(In reply to comment #10)

> Could you please include other common sections like VERSION, SEE ALSO,
> AUTHORS? You may also state that you created the man page but I'm not sure
> where it's supposed to be placed.
> 

According to http://kernel.org/doc/man-pages/online/pages/man7/man-pages.7.html

VERSIONS doesn't seem to be relevant here (or is it?).
AUTHORS is "strongly discouraged" (and the contents for firefox.1 is 90%+ just 'firefox -h')

> As for the SEE ALSO section, if you create a man page for other products
> (thunderbird, xulrunner, seamonkey?) we'll update those man pages too.
> 

I don't know if thunderbird/seamonkey are related to the point of being in the SEE ALSO section as they don't interfere with firefox, I think.
xulrunner probably yes and it has a simple help output. I could make a man page for it but I would have to first look at what it is and how it interferes with the mozilla apps so I don't know yet when I'll do it.

Comment 12 Martin Stransky 2012-10-30 14:31:03 UTC
Thanks, added to rawhide.

Comment 13 Steve 2012-11-23 02:00:08 UTC
upgraded to firefox-17.0
still providing man page dated August 07, 2001


Note You need to log in before you can comment on or make changes to this bug.