From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Hadron Quark Newsgroups: gmane.emacs.help Subject: Re: Why I can't use `info' in emacs? Date: Sat, 16 Dec 2006 23:30:08 +0100 Message-ID: <5qlkl7cw3z.fsf@gmail.com> References: <458268D7.6020203@163.com> <1166191335.058714.266970@80g2000cwy.googlegroups.com> <1166206305.278573.25520@n67g2000cwd.googlegroups.com> NNTP-Posting-Host: dough.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: sea.gmane.org 1166308887 3701 80.91.229.10 (16 Dec 2006 22:41:27 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 16 Dec 2006 22:41:27 +0000 (UTC) Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sat Dec 16 23:41:24 2006 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by dough.gmane.org with esmtp (Exim 4.50) id 1GviDZ-0005Vs-OU for geh-help-gnu-emacs@m.gmane.org; Sat, 16 Dec 2006 23:41:22 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GviDZ-0001PO-9e for geh-help-gnu-emacs@m.gmane.org; Sat, 16 Dec 2006 17:41:21 -0500 Original-Path: shelby.stanford.edu!newsfeed.stanford.edu!news.tele.dk!news.tele.dk!small.news.tele.dk!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail Original-Newsgroups: gnu.emacs.help Original-Lines: 75 Original-X-Trace: individual.net Wi8ZecfHwPociZz3p0FeqAFSHk/xPeonfV6iCgnITmFDeRZB0l X-Orig-Path: news.individual.net!news X-Face: 2h#||Cd#d%F*NCm59[_6/{1a@jy%; |j>{D~4^gKg(^i%7j0IK?+,/GmW&:CD5fEKb_! User-Agent: Gnus Cancel-Lock: sha1:Xd+HJJ+7YG12FeQ005oZcF7gxhQ= Original-Xref: shelby.stanford.edu gnu.emacs.help:144041 Original-To: help-gnu-emacs@gnu.org X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:39644 Archived-At: Eli Zaretskii writes: >> From: Hadron Quark >> Date: Sat, 16 Dec 2006 20:21:32 +0100 >> > >> > The most common reason I have for looking at API docs is to remind me >> > of the order of arguments in a function. Mostly I can remember the >> > functions purpose. We're all different. >> > >> >> Hence the man page is superior :-; > > The information about the arguments is there in the Info manual as > well. > Again : Did you *read* the excerpts I posted coming up from the code? As a first page context help, the man page is superior to the info file node which first appears. From a programming perspective. Here it is again : (a) man page using manual-entry(current-word): ,---- | PRINTF(3) Linux Programmer’s Manual PRINTF(3) | | NAME | printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf, vsnprintf - formatted output conversion | | SYNOPSIS | #include | | int printf(const char *format, ...); | int fprintf(FILE *stream, const char *format, ...); | int sprintf(char *str, const char *format, ...); | int snprintf(char *str, size_t size, const char *format, ...); | | #include | | int vprintf(const char *format, va_list ap); | int vfprintf(FILE *stream, const char *format, va_list ap); | int vsprintf(char *str, const char *format, va_list ap); | int vsnprintf(char *str, size_t size, const char *format, va_list ap); | | DESCRIPTION | The functions in the printf() family produce output according to a format as described below. The functions | printf() and vprintf() write output to stdout, the standard output stream; fprintf() and vfprintf() write out‐ | put to the given output stream; sprintf(), snprintf(), vsprintf() and vsnprintf() write to the character string | str. | `---- (b) info entry: ,---- | 12.12.7 Formatted Output Functions | ---------------------------------- | | This section describes how to call `printf' and related functions. | Prototypes for these functions are in the header file `stdio.h'. | Because these functions take a variable number of arguments, you _must_ | declare prototypes for them before using them. Of course, the easiest | way to make sure you have all the right prototypes is to just include | `stdio.h'. | | -- Function: int printf (const char *TEMPLATE, ...) | The `printf' function prints the optional arguments under the | control of the template string TEMPLATE to the stream `stdout'. | It returns the number of characters printed, or a negative value | if there was an output error. | `---- --