From nobody@FreeBSD.org  Mon Jan 10 14:33:52 2005
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B3E5C16A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 10 Jan 2005 14:33:52 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A4D7A43D5A
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 10 Jan 2005 14:33:52 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id j0AEXqO1035364
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 10 Jan 2005 14:33:52 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id j0AEXqdO035351;
	Mon, 10 Jan 2005 14:33:52 GMT
	(envelope-from nobody)
Message-Id: <200501101433.j0AEXqdO035351@www.freebsd.org>
Date: Mon, 10 Jan 2005 14:33:52 GMT
From: Enrique Matas Snchez (aka Quique) <cronopios@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: /usr/lib entry in hier(7) man page
X-Send-Pr-Version: www-2.3

>Number:         76056
>Category:       docs
>Synopsis:       /usr/lib entry in hier(7) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jan 10 14:40:20 GMT 2005
>Closed-Date:    Mon Jan 17 11:56:35 GMT 2005
>Last-Modified:  Mon Jan 17 11:56:35 GMT 2005
>Originator:     Enrique Matas Snchez (aka Quique)
>Release:        5.3-RELEASE
>Organization:
>Environment:
>Description:
      [N.B.: I am not a native English speaker, so this might actually be my problem].

I don't really understand the /usr/lib entry in the hier man page:
 
    lib/	  archive libraries

>How-To-Repeat:
      
>Fix:
      The FHS explanation seems more clear:

    /usr/lib : Libraries for programming and packages

/usr/lib includes object files, libraries, and internal binaries that are not intended to be executed directly by users or shell scripts.
>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <keramida@ceid.upatras.gr>
To: Enrique =?iso-8859-7?Q?Mat=EDas?= Sanchez <cronopios@gmail.com>
Cc: bug-followup@freebsd.org
Subject: Re: docs/76056: /usr/lib entry in hier(7) man page
Date: Mon, 10 Jan 2005 17:15:06 +0200

 On 2005-01-10 14:33, Enrique Matas Snchez <cronopios@gmail.com> wrote:
 >
 > [N.B.: I am not a native English speaker, so this might actually be my problem].
 >
 > I don't really understand the /usr/lib entry in the hier man page:
 >
 >     lib/	  archive libraries
 
 Libraries *are* 'archives'.  Archives of object files.
 
 > The FHS explanation seems more clear:
 >
 > /usr/lib : Libraries for programming and packages
 >
 > /usr/lib includes object files, libraries, and internal binaries
 > that are not intended to be executed directly by users or shell
 > scripts.
 
 ``object files and libraries'' matches the state of /usr/lib in
 FreeBSD.  There are AFAIK _no_ binaries that are "not intented to be
 executed by users or shell scripts".
 
 The object files are, indeed, not what the every day user may want to
 use, but they *are* used indirectly when a C program is linked:
 
 $ find /usr/lib | \
   grep -v '\.a$' | grep -v '\.so$' | grep -v '\.so.[0-9][0-9]*$' | \
   xargs ls -ld
 drwxr-xr-x  4 root  wheel  8704 Jan 10 16:38 /usr/lib
 drwxr-xr-x  2 root  wheel   512 Jul 21 18:41 /usr/lib/aout
 drwxr-xr-x  3 root  wheel   512 Oct 12 12:56 /usr/lib/compat
 drwxr-xr-x  2 root  wheel  2048 Oct 11 14:30 /usr/lib/compat/aout
 -r--r--r--  1 root  wheel  1360 Jan 10 16:35 /usr/lib/crt1.o
 -r--r--r--  1 root  wheel  1856 Jan 10 16:36 /usr/lib/crtbegin.o
 -r--r--r--  1 root  wheel  2220 Jan 10 16:36 /usr/lib/crtbeginS.o
 -r--r--r--  1 root  wheel  1212 Jan 10 16:36 /usr/lib/crtend.o
 -r--r--r--  1 root  wheel  1260 Jan 10 16:36 /usr/lib/crtendS.o
 -r--r--r--  1 root  wheel   876 Jan 10 16:35 /usr/lib/crti.o
 -r--r--r--  1 root  wheel   832 Jan 10 16:35 /usr/lib/crtn.o
 -r--r--r--  1 root  wheel  1524 Jan 10 16:35 /usr/lib/gcrt1.o
 -r--r--r--  1 root  wheel  8410 Jan 10 16:37 /usr/lib/kgzldr.o
 $
 
 The description of hier(7) is a bit terse, but it is true IMHO.
 
 - Giorgos
 

From: =?ISO-8859-1?Q?Enrique_Mat=EDas_S=E1nchez_=28Quique=29?= <cronopios@gmail.com>
To: Giorgos Keramidas <keramida@ceid.upatras.gr>
Cc: bug-followup@freebsd.org
Subject: Re: docs/76056: /usr/lib entry in hier(7) man page
Date: Mon, 10 Jan 2005 16:37:36 +0100

 On Mon, 10 Jan 2005 17:15:06 +0200, Giorgos Keramidas
 <keramida@ceid.upatras.gr> wrote:
 
 > > I don't really understand the /usr/lib entry in the hier man page:
 > >
 > >     lib/        archive libraries
 > 
 > Libraries *are* 'archives'.  Archives of object files.
 
 I just found a webpage
 (http://docs.hp.com/en/B2355-90655/ch05s01.html) about HP-UX
 explaining that there are two types of libraries: shared and archive
 libraries.
 Archive libraries are indeed archives of object files created with the
 ar command.
 
 I am not a programmer, and didn't know about that; therefore my confusion.
 
 
 > The description of hier(7) is a bit terse, but it is true IMHO.
  
 Absolutelly.
 
 Maybe it should be explained somewhere what an archive library is? The
 handbook does not explain about it.
 
 Thanks for your time and reply,
  Quique
  
 -- 
 It's never too late to have a happy childhood.

From: Giorgos Keramidas <keramida@freebsd.org>
To: "Enrique Mat?as S?nchez (Quique)" <cronopios@gmail.com>
Cc: bug-followup@freebsd.org
Subject: Re: docs/76056: /usr/lib entry in hier(7) man page
Date: Mon, 10 Jan 2005 17:46:01 +0200

 On 2005-01-10 16:37, "Enrique Mat?as S?nchez (Quique)" <cronopios@gmail.com> wrote:
 >On Mon, 10 Jan 2005 17:15:06 +0200, Giorgos Keramidas wrote:
 >>> I don't really understand the /usr/lib entry in the hier man page:
 >>>
 >>>     lib/        archive libraries
 >>
 >> Libraries *are* 'archives'.  Archives of object files.
 >
 > I just found a webpage
 > (http://docs.hp.com/en/B2355-90655/ch05s01.html) about HP-UX
 > explaining that there are two types of libraries: shared and archive
 > libraries.  Archive libraries are indeed archives of object files
 > created with the ar command.
 >
 > I am not a programmer, and didn't know about that; therefore my confusion.
 >
 >> The description of hier(7) is a bit terse, but it is true IMHO.
 >
 > Absolutelly.
 >
 > Maybe it should be explained somewhere what an archive library is? The
 > handbook does not explain about it.
 
 I can change the description of /usr/lib to:
 
 	lib/	   shared and archive ar(1)-type libraries
 
 Does this seem a good way to point the reader to ar(1) -- where a good
 explanation of what archive libraries are can be found?
 

From: =?ISO-8859-1?Q?Enrique_Mat=EDas_S=E1nchez_=28Quique=29?= <cronopios@gmail.com>
To: Giorgos Keramidas <keramida@freebsd.org>
Cc: bug-followup@freebsd.org
Subject: Re: docs/76056: /usr/lib entry in hier(7) man page
Date: Mon, 10 Jan 2005 16:58:16 +0100

 On Mon, 10 Jan 2005 17:46:01 +0200, Giorgos Keramidas
 <keramida@freebsd.org> wrote:
  
 > >> Libraries *are* 'archives'.  Archives of object files.
 > >
 > > I just found a webpage
 > > (http://docs.hp.com/en/B2355-90655/ch05s01.html) about HP-UX
 > > explaining that there are two types of libraries: shared and archive
 > > libraries.  Archive libraries are indeed archives of object files
 > > created with the ar command.
 > >
 > > I am not a programmer, and didn't know about that; therefore my confusion.
  
 > > Maybe it should be explained somewhere what an archive library is? The
 > > handbook does not explain about it.
 > 
 > I can change the description of /usr/lib to:
 > 
 >         lib/       shared and archive ar(1)-type libraries
 > 
 > Does this seem a good way to point the reader to ar(1) -- where a good
 > explanation of what archive libraries are can be found?
 
 Yes! That sounds just nice :-)
 
 Thank you,
  Quique
 
 -- 
 It's never too late to have a happy childhood.
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Mon Jan 10 16:06:30 GMT 2005 
State-Changed-Why:  
I committed a nicer description to CURRENT.  Thanks :-) 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Mon Jan 10 16:06:30 GMT 2005 
Responsible-Changed-Why:  
I will MFC this to RELENG_5 in a few days. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=76056 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Mon Jan 17 11:56:10 GMT 2005 
State-Changed-Why:  
Merged to RELENG_5 in revision 1.110.2.1. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=76056 
>Unformatted:
