manual pages for firefox and thunderbird

RESOLVED WONTFIX

Status

Firefox Graveyard
Help Documentation
P5
enhancement
RESOLVED WONTFIX
11 years ago
2 years ago

People

(Reporter: Martynas Venckus, Unassigned)

Tracking

unspecified
Future
x86
All

Details

Attachments

(2 attachments, 2 obsolete attachments)

(Reporter)

Description

11 years ago
User-Agent:       Mozilla/5.0 (X11; U; OpenBSD i386; en-US; rv:1.8.1.1) Gecko/20070216 Firefox/2.0.0.1
Build Identifier: Mozilla/5.0 (X11; U; OpenBSD i386; en-US; rv:1.8.1.1) Gecko/20070216 Firefox/2.0.0.1

cd xpfe/bootstrap && gmake firefox.1 produces outdated and incorrect manual page. What about creating separate *.man.ins for firefox and thunderbird which could be distributed with the package?

Reproducible: Always

Steps to Reproduce:
1.
2.
3.
(Reporter)

Comment 1

11 years ago
Created attachment 255444 [details] [diff] [review]
Patch we use with OpenBSD/firefox
(Reporter)

Comment 2

11 years ago
Marking OS: All.
OS: OpenBSD → All

Comment 3

11 years ago
Comment on attachment 255444 [details] [diff] [review]
Patch we use with OpenBSD/firefox

no. xpfe is for xpfe (suite, seamonkey).

if someone else is using it, they're very broken.
Attachment #255444 - Flags: review-
(Reporter)

Comment 4

11 years ago
We are using only the manual page.

Okay, what about having man page for firefox's shell script then? It's really nice to have description of what it is and describe switches for users. Don't you agree?

Comment 5

11 years ago
*shrug* not my content. i'm not opposed.
(Reporter)

Comment 6

11 years ago
Component: Help/Documentation. CC some mozilla.man.in people.
Component: Build Config → Help Documentation
(Reporter)

Comment 7

11 years ago
Created attachment 255605 [details] [diff] [review]
firefox.man.in
(Reporter)

Comment 8

11 years ago
Created attachment 255607 [details] [diff] [review]
Makefile.in.diff

Okay, what about having separate manual pages for all applications (MOZ_APP_NAME)? The descriptions, shell scripts, switches, etc. should be documented.
(Reporter)

Comment 9

11 years ago
Any way to get some action on this?

Comment 10

11 years ago
Future SeaMonkey versions (based on toolkit) should already be using their own man pages from suite/app - I never would have thought that Firefox or Thunderbird would be using the one from xpfe/bootstrap, I thought that was suite-only...

In any case, new man files for them should not live anywhere in xpfe/ but should be in browser/app/ and mail/app/ just like our new one is in suite/app/
(Reporter)

Updated

11 years ago
Severity: normal → enhancement
Status: UNCONFIRMED → NEW
Ever confirmed: true
Summary: update manual page for firefox (and thunderbird) → manual pages for firefox and thunderbird
(Reporter)

Comment 11

11 years ago
Created attachment 257056 [details] [diff] [review]
browser_app_Makefile.in.diff

Manual page for firefox.
Attachment #255444 - Attachment is obsolete: true
Attachment #255607 - Attachment is obsolete: true
(Reporter)

Comment 12

11 years ago
Any progress?
QA Contact: build.config → help.documentation

Comment 13

11 years ago
Comment on attachment 257056 [details] [diff] [review]
browser_app_Makefile.in.diff

You're missing the GARBAGE line and the endif from the original code:
http://bonsai.mozilla.org/cvsblame.cgi?file=mozilla/xpfe/bootstrap/Makefile.in&mark=399-410,429-431#399

You should create patches with cvs diff -up8, so that bugzilla's patch viewer can link to the patched files:
http://developer.mozilla.org/en/docs/Creating_a_patch

Then you have to request review from a qualified person:
http://www.mozilla.org/projects/firefox/review.html
Click the "Details" link on the patches, set the review flag to "?" and enter the requestee's email address.
Attachment #257056 - Flags: review-
Not sure this is useful, not sure this is bad though.  P5/Future though, seems easier to just stick this on the support wiki.
Priority: -- → P5
Target Milestone: --- → Future
We do not intend to fix this.
Status: NEW → RESOLVED
Last Resolved: 2 years ago
Resolution: --- → WONTFIX
(Assignee)

Updated

2 years ago
Product: Firefox → Firefox Graveyard
You need to log in before you can comment on or make changes to this bug.