From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Robert Thorpe Newsgroups: gmane.emacs.help Subject: Re: Documentation on the command-line? Date: Thu, 03 Jul 2014 03:24:53 +0100 Message-ID: <87y4wb2n7u.fsf@robertthorpeconsulting.com> References: <87fvik1900.fsf@debian.uxu> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1404354330 21197 80.91.229.3 (3 Jul 2014 02:25:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 3 Jul 2014 02:25:30 +0000 (UTC) Cc: help-gnu-emacs@gnu.org To: Emanuel Berg Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Thu Jul 03 04:25:23 2014 Return-path: Envelope-to: geh-help-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 1X2Wi9-0002dh-OB for geh-help-gnu-emacs@m.gmane.org; Thu, 03 Jul 2014 04:25:21 +0200 Original-Received: from localhost ([::1]:57356 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X2Wi9-0006HY-9m for geh-help-gnu-emacs@m.gmane.org; Wed, 02 Jul 2014 22:25:21 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50321) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X2Whr-00065x-3l for help-gnu-emacs@gnu.org; Wed, 02 Jul 2014 22:25:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X2Whl-0001Yc-3R for help-gnu-emacs@gnu.org; Wed, 02 Jul 2014 22:25:03 -0400 Original-Received: from outbound-smtp06.blacknight.com ([81.17.249.39]:44958) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X2Whk-0001Xx-TS for help-gnu-emacs@gnu.org; Wed, 02 Jul 2014 22:24:57 -0400 Original-Received: from mail.blacknight.com (pemlinmail04.blacknight.ie [81.17.254.17]) by outbound-smtp06.blacknight.com (Postfix) with ESMTP id 47A8198B35 for ; Thu, 3 Jul 2014 02:21:52 +0000 (UTC) Original-Received: (qmail 11081 invoked from network); 3 Jul 2014 02:24:54 -0000 Original-Received: from unknown (HELO RTLaptop) (rt@robertthorpeconsulting.com@[109.77.193.91]) by 81.17.254.9 with ESMTPSA (DHE-RSA-AES128-SHA encrypted, authenticated); 3 Jul 2014 02:24:54 -0000 In-Reply-To: <87fvik1900.fsf@debian.uxu> (message from Emanuel Berg on Wed, 02 Jul 2014 10:05:03 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 81.17.249.39 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:98523 Archived-At: Emanuel Berg writes: > Robert Thorpe writes: ... > Aha, that explains it. Yeah, I remember I had to > install the gcc documentation (gcc-doc) explicitly for, > I guess, the same reason. > > Yeah, what is the reason? Most free-software/open-source licenses require someone passing on the code to pass on the license. The GNU Free Documentation License als requires them to include a little essay by RMS. The Debian maintainers objected to that and labeled GFDL a "non-free" license. There was a kerfuffle about it a few years ago. > In /etc/apt/sources.list, put for example: > > deb http://ftp.se.debian.org/debian/ jessie main non-free contrib > deb-src http://ftp.se.debian.org/debian/ jessie main non-free contrib > > But, what is the Emacs pack called? There is no emacs-doc. emacs24-common-non-dfsg It's worth installing the info files in my opinion. The info browsers (both Emacs' and the standalone one) are very fast and have useful keybindings. Emacs' info browser is integrated with the rest of Emacs. In Emacs if you type C-h K then an Emacs keybinding it'll take you to the place in the Info manual describing that binding. That's a useful adjunt to C-h k because the info manual describes several keys at once, so you get to know similar keys. C-h F does the same thing for functions. If you install the Glibc info files then if you type C-h S on a C or C++ library function-name then it'll take you to that function's documentation. The same applies to other GCC based languages if you use the mode for that language and install the info files. Standalone "info -O tar" will take you to the part of the manual that describes the command-line options. That is, it behaves like a Man-page and shows you command-line stuff first. BR, Robert Thorpe