bug#17310: 24.3; clarify emacsclient(1) manpage link to "(emacs)Emacs Server"

bug#17310: 24.3; clarify emacsclient(1) manpage link to "(emacs)Emacs Server"

[Samuel Bronson]

[-- Attachment #1: Type: text/plain, Size: 553 bytes --]

Tags: patch

It would be helpful if the manpage for emacsclient had a more prominent
(i.e. bold) and more explicit link to (info "(emacs)Emacs Server"),
perhaps using something like the included patch.

In GNU Emacs 24.3.1 (i486-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2013-12-22 on binet, modified by Debian
Windowing system distributor `Colin Harrison', version 11.0.60900031
System Description:	Debian GNU/Linux testing (jessie)

Important settings:
  value of $LC_COLLATE: C
  value of $LANG: en_US.UTF-8
  locale-coding-system: utf-8-unix


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: emacsclient.1.patch --]
[-- Type: text/x-patch; name=emacsclient.1.patch, Size: 1069 bytes --]

diff -u /home/naesten/hacking/emacsclient.orig.1 /home/naesten/hacking/emacsclient.1
*** /home/naesten/hacking/emacsclient.orig.1	2014-04-21 13:04:31.000000000 -0400
--- /home/naesten/hacking/emacsclient.1	2014-04-21 13:37:07.000000000 -0400
***************
*** 93,99 ****
  .SH "SEE ALSO"
  The program is documented fully in
  .IR "Using Emacs as a Server"
! available via the Info system.
  .SH AUTHOR
  This manual page was written by Stephane Bortzmeyer <bortzmeyer@debian.org>,
  for the Debian GNU/Linux system (but may be used by others).
--- 93,108 ----
  .SH "SEE ALSO"
  The program is documented fully in
  .IR "Using Emacs as a Server"
! available via the Info system.  You should be able to reach it using the
! shell command
! .IP
! .B info emacs \(aqEmacs Server\(aq
! .PP
! or by evaluating
! .IP
! .B (info \(dq(emacs)Emacs Server\(dq)
! .PP
! in Emacs.
  .SH AUTHOR
  This manual page was written by Stephane Bortzmeyer <bortzmeyer@debian.org>,
  for the Debian GNU/Linux system (but may be used by others).

Diff finished.  Mon Apr 21 13:37:21 2014

bug#17310: 24.3; clarify emacsclient(1) manpage link to "(emacs)Emacs Server"

[Glenn Morris]

Samuel Bronson wrote:

> It would be helpful if the manpage for emacsclient had a more prominent
> (i.e. bold) and more explicit link to (info "(emacs)Emacs Server"),
> perhaps using something like the included patch.

Thanks for the patch, but IMO it's not worth applying.
It's not the job of every man page to explain how to use info.

> *** /home/naesten/hacking/emacsclient.orig.1	2014-04-21 13:04:31.000000000 -0400
> --- /home/naesten/hacking/emacsclient.1	2014-04-21 13:37:07.000000000 -0400
> ***************
> *** 93,99 ****
>   .SH "SEE ALSO"
>   The program is documented fully in
>   .IR "Using Emacs as a Server"
> ! available via the Info system.
>   .SH AUTHOR
>   This manual page was written by Stephane Bortzmeyer <bortzmeyer@debian.org>,
>   for the Debian GNU/Linux system (but may be used by others).
> --- 93,108 ----
>   .SH "SEE ALSO"
>   The program is documented fully in
>   .IR "Using Emacs as a Server"
> ! available via the Info system.  You should be able to reach it using the
> ! shell command
> ! .IP
> ! .B info emacs \(aqEmacs Server\(aq
> ! .PP
> ! or by evaluating
> ! .IP
> ! .B (info \(dq(emacs)Emacs Server\(dq)
> ! .PP
> ! in Emacs.
>   .SH AUTHOR

bug#17310: 24.3; clarify emacsclient(1) manpage link to "(emacs)Emacs Server"

[Josh]

[-- Attachment #1: Type: text/plain, Size: 819 bytes --]

On Tue, Apr 29, 2014 at 7:15 AM, Glenn Morris <rgm@gnu.org> wrote:

> Samuel Bronson wrote:
>
> > It would be helpful if the manpage for emacsclient had a more prominent
> > (i.e. bold) and more explicit link to (info "(emacs)Emacs Server"),
> > perhaps using something like the included patch.
>
> Thanks for the patch, but IMO it's not worth applying.
> It's not the job of every man page to explain how to use info.
>

Agreed, but the current text ("The program is documented fully in
Using Emacs as a Server available via the Info system.") isn't very
helpful to users who are unfamiliar with GNU Info.  Such users would
be more likely to find their way to the complete documentation if we
appended something like ", which can be invoked on most systems
by issuing the `info' shell command." to the language above.

[-- Attachment #2: Type: text/html, Size: 1448 bytes --]