bug#5346: 23.1.91; document --maximized etc. on man page

bug#5346: 23.1.91; document --maximized etc. on man page

[jidanni]

>>>>> "JD" == Jan Djärv <jan.h.d@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)

bug#5346: 23.1.91; document --maximized etc. on man page

[Jan Djärv]

jidanni@jidanni.org skrev:
>>>>>> "JD" == Jan Djärv <jan.h.d@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.

bug#5346: 23.1.91; document --maximized etc. on man page

[jidanni]

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.

bug#5346: 23.1.91; document --maximized etc. on man page

[Chong Yidong]

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

Fixed, thanks.