Re: [PATCH v4 08/10] intro.3: wfix

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 





On 1/7/23 13:45, Alejandro Colomar wrote:
Hi Branden,

On 1/7/23 10:55, G. Branden Robinson wrote:
* Tighten cross reference.  It wastes words to tell people to look
   elsewhere "for further information".  Why else would they look there?
* Use passive voice less.
* Relocate sentence for more coherent discussion.
* Say "application _programming_ interface".

I noticed that when you sent it, but thought that maybe it was just another way of saying it.  Duckduckgo seemed to have several instances of that alternative expansion of API, so I accepted it.  I'm curious about "application program interace", since I hadn't heard about it before your patch; is it a normal expansion of API?


Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>

Patch applied.

Hmm, after reconsideration, I've dropped the patch.  I'm not sure about it.


Cheers,

Alex

---
  man3/intro.3 | 23 ++++++++++++-----------
  1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/man3/intro.3 b/man3/intro.3
index d6d91f6bd..bbaef525e 100644
--- a/man3/intro.3
+++ b/man3/intro.3
@@ -42,9 +42,8 @@ must be defined before including
  .I any
  header files.)
  In such cases,
-the required macro is described in the man page.
-For further information on feature test macros,
-see
+the relevant function's man page describes the required macro.
+See
  .BR feature_test_macros (7).
  .\"
  .\" There
@@ -77,9 +76,16 @@ see
  .\" Various special libraries.  The manual pages documenting their functions
  .\" specify the library names.
  .SS Subsections
-Section 3 of this manual is organized into subsections
+The Linux
+.I man-pages
+organize section 3 into subsections
  that reflect the complex structure of the standard C library
-and its many implementations:
+and its many implementations.
+.IR libc 's
+difficult history frequently makes it a poor example to follow
+in design,
+implementation,
+and presentation.
  .IP \(bu 3
  3const
  .IP \(bu
@@ -87,11 +93,6 @@ and its many implementations:
  .IP \(bu
  3type
  .PP
-This difficult history frequently makes it a poor example to follow
-in design,
-implementation,
-and presentation.
-.PP
  Ideally,
  a library for the C language
  is designed such that each header file
@@ -101,7 +102,7 @@ and exposes only data types and constants that
  are required for use of those functions.
  Together,
  these are termed an API or
-.IR "application program interface" .
+.IR "application programming interface" .
  Types and constants to be shared among multiple APIs
  should be placed in header files that declare no functions.
  This organization permits a C library module


--
<http://www.alejandro-colomar.es/>

Attachment: OpenPGP_signature
Description: OpenPGP digital signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux