From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Josh Newsgroups: gmane.emacs.bugs Subject: bug#17310: 24.3; clarify emacsclient(1) manpage link to "(emacs)Emacs Server" Date: Tue, 29 Apr 2014 08:29:25 -0700 Message-ID: References: <8761m2a7ew.fsf@naesten.mooo.com> <0dvbtskyqu.fsf@fencepost.gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=20cf3036387da03b8004f8301a81 X-Trace: ger.gmane.org 1398785489 3030 80.91.229.3 (29 Apr 2014 15:31:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 29 Apr 2014 15:31:29 +0000 (UTC) Cc: Samuel Bronson , 17310@debbugs.gnu.org To: Glenn Morris Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Apr 29 17:31:21 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1WfA06-0005VW-Rq for geb-bug-gnu-emacs@m.gmane.org; Tue, 29 Apr 2014 17:31:19 +0200 Original-Received: from localhost ([::1]:50695 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WfA06-0002nr-FJ for geb-bug-gnu-emacs@m.gmane.org; Tue, 29 Apr 2014 11:31:18 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46565) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wf9zx-0002ly-B4 for bug-gnu-emacs@gnu.org; Tue, 29 Apr 2014 11:31:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Wf9zr-00051A-GJ for bug-gnu-emacs@gnu.org; Tue, 29 Apr 2014 11:31:09 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:56108) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wf9zr-0004zy-Dk for bug-gnu-emacs@gnu.org; Tue, 29 Apr 2014 11:31:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Wf9zq-0005z3-Dr for bug-gnu-emacs@gnu.org; Tue, 29 Apr 2014 11:31:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Josh Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 29 Apr 2014 15:31:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 17310 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 17310-submit@debbugs.gnu.org id=B17310.139878540819258 (code B ref 17310); Tue, 29 Apr 2014 15:31:02 +0000 Original-Received: (at 17310) by debbugs.gnu.org; 29 Apr 2014 15:30:08 +0000 Original-Received: from localhost ([127.0.0.1]:45224 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Wf9yw-0004zL-2g for submit@debbugs.gnu.org; Tue, 29 Apr 2014 11:30:07 -0400 Original-Received: from mail-yh0-f52.google.com ([209.85.213.52]:61144) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Wf9yr-0004wS-Nm for 17310@debbugs.gnu.org; Tue, 29 Apr 2014 11:30:03 -0400 Original-Received: by mail-yh0-f52.google.com with SMTP id a41so157682yho.11 for <17310@debbugs.gnu.org>; Tue, 29 Apr 2014 08:29:55 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc:content-type; bh=IO6LxurQJy7vN7HXs3jO1evktqq9AHV8W/oQkS0MkQ4=; b=ClYqS9Q5hwAtWeWvHSkXfvjcfLNYLQwYXg1rqQNgTSkRUNVlIt/eqDG9mH1fHkKaXM PrkFV2JlN+VvCIIiDYkgzpTK2dN4Kp3nCs5BPs7KD3EV/B1U84GES/oVubC90JcWK4no baH3joXq8G7AitVMQPQ8NMuJJMWht+oR8k3uFzQAyQLfUCu42kpPGd783mjQOI5MacAt GaLZbsPJvpZ/t25z0hS7nZjQoNzcj/PfSV/D0kErAg7B50/aU6axHCAZc6OWxjRty2P0 BgUy5Es6LjDN/4/LjpDQ7Qq5Qk9XWKD+NnhDj8J8gaG/mB/ByRrdXjbMkCmqBKa3EqLh b3TA== X-Gm-Message-State: ALoCoQkIkiTGQKSvwRZWqcB/asiUx4+Qmhj2gg/2j5u9W/kQ+WUHe2itjSpvhhLLWy5Y6qtVQqKO X-Received: by 10.236.116.99 with SMTP id f63mr46565582yhh.10.1398785395657; Tue, 29 Apr 2014 08:29:55 -0700 (PDT) Original-Received: by 10.170.117.65 with HTTP; Tue, 29 Apr 2014 08:29:25 -0700 (PDT) In-Reply-To: <0dvbtskyqu.fsf@fencepost.gnu.org> X-Google-Sender-Auth: 2XabspOkZRDG3ThYcVAna__HtWY X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:88432 Archived-At: --20cf3036387da03b8004f8301a81 Content-Type: text/plain; charset=UTF-8 On Tue, Apr 29, 2014 at 7:15 AM, Glenn Morris 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. --20cf3036387da03b8004f8301a81 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
On T= ue, 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 prominen= t
> (i.e. bold) and more explicit link to (info "(emacs)Emacs Server&= quot;),
> 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 pr= ogram is documented fully in
Using Emacs as a Server available vi= a the Info system.") isn't very
helpful to users who are unfamiliar with GNU Info. =C2=A0Such users wo= uld
be more likely to find their way to the complete documentatio= n if we
appended something like ", which can be invoked on m= ost systems=C2=A0
by issuing the `info'=C2=A0shell= command." to the language above.
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0
=
--20cf3036387da03b8004f8301a81--