GNU bug report logs - #5346
23.1.91; document --maximized etc. on man page

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 5346 in the body.
You can then email your comments to 5346 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: jidanni <at> jidanni.org
To: emacs-pretest-bug <at> gnu.org
Subject: 23.1.91; document --maximized etc. on man page
Date: Sat, 09 Jan 2010 11:30:47 +0800

>>>>> "JD" == Jan Djärv <jan.h.d <at> swipnet.se> writes:

JD> Well, -Q ignores X resources, try -q instead.

This fact is not documented on the emacs man page.

JD> You could try -mm also.

One finds that in emacs --help, but not on the man page. Same with
--maximized.

There are probably more such cases too.

P.S.,
$ cat ~/bin/emacs
emacs-snapshot -mm "$@"
#emacs-snapshot --maximized "$@"
The first line is compatible with -nw, the second causes an error!
Occasionally I use -nw and don't want an error to occur.

In GNU Emacs 23.1.91.1 (i486-pc-linux-gnu, GTK+ Version 2.18.5)
 of 2010-01-07 on elegiac, modified by Debian
 (emacs-snapshot package, version 1:20100106-1)

Message #8 received at 5346 <at> debbugs.gnu.org (full text, mbox):

From: Jan Djärv <jan.h.d <at> swipnet.se>
To: jidanni <at> jidanni.org, 5346 <at> debbugs.gnu.org
Subject: Re: bug#5346: 23.1.91; document --maximized etc. on man page
Date: Sat, 09 Jan 2010 13:34:49 +0100

jidanni <at> jidanni.org skrev:
>>>>>> "JD" == Jan Djärv <jan.h.d <at> swipnet.se> writes:
> 
> JD> Well, -Q ignores X resources, try -q instead.
> 
> This fact is not documented on the emacs man page.
> 
> JD> You could try -mm also.
> 
> One finds that in emacs --help, but not on the man page. Same with
> --maximized.

Well, the man page do say:
       The primary documentation of GNU Emacs is  in  the  GNU  Emacs Manual,
       which  you  can  read  using Info, either from Emacs or as a standalone
       program.  Please look there for complete and up-to-date  documentation.
       This  man  page  is  updated only when someone volunteers to do so; the
       Emacs maintainers' priority goal is to minimize the amount of time this
       man page takes away from other more useful projects.

You are free to update it if you wan't.  I seems to have been updated last 
2008-12-14, and the -Q and --maximized changes are earlier than that.

> 
> There are probably more such cases too.
> 
> P.S.,
> $ cat ~/bin/emacs
> emacs-snapshot -mm "$@"
> #emacs-snapshot --maximized "$@"
> The first line is compatible with -nw, the second causes an error!
> Occasionally I use -nw and don't want an error to occur.
> 

That was a bug, now fixed.

	Jan D.

Message #11 received at 5346 <at> debbugs.gnu.org (full text, mbox):

From: jidanni <at> jidanni.org
To: jan.h.d <at> swipnet.se
Cc: 5346 <at> debbugs.gnu.org
Subject: Re: bug#5346: 23.1.91; document --maximized etc. on man page
Date: Sun, 10 Jan 2010 02:42:10 +0800

JD> The primary documentation of GNU Emacs is in the GNU Emacs Manual,
JD> which you can read using Info
I'd move all the options off of the manual page then, because when one
does $ man emacs and pages down to the middle, one thinks he is now
aware of all the options. One does not first look at the fine print.
Compare man cpio. But then again compare man cat.

Hmmm, on the bottom of man cat it says to see
info coreutils 'cat invocation'
but on the bottom of man cpio it doesn't say to see
info cpio options
but instead just
info cpio.
I'm going to take a little vacation.

Message #14 received at 5346 <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> stupidchicken.com>
To: jidanni <at> jidanni.org
Cc: 5346 <at> debbugs.gnu.org
Subject: Re: 23.1.91; document --maximized etc. on man page
Date: Sat, 09 Jan 2010 18:40:29 -0500

> JD> Well, -Q ignores X resources, try -q instead.
>
> This fact is not documented on the emacs man page.

Fixed, thanks.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.