Re: man types.h

2013-01-18 Thread Colin Watson
On Thu, Jan 17, 2013 at 02:05:47PM +0100, Lanoxx wrote:
 On 17/01/13 13:40, Oliver Grawert wrote:
 Am Donnerstag, den 17.01.2013, 13:11 +0100 schrieb Lanoxx:
 it seems that for solaris there exists a man page for types.h [1] but I
 could not find such a man page on ubuntu. Could someone give me a hint,
 why it does not exist or is the man page name just different on ubuntu?
 
 the manpage for types.h is in the manpages-posix-dev package, note that
 we dont install devleoper documentation by default ...
 
 Thanks, that was what I was looking for. Maybe you can make
 manpages-dev recommend this package, so it is automatically
 installed if developer manpages are installed?

The one in manpages-posix-dev is not really quite the same.  What that
documents is what POSIX guarantees of sys/types.h, not what the system
provides; so it won't tell you about any system-specific extensions,
some of which might be very important to you (e.g. large file support).

I think manpages-posix(-dev) are useful packages and I'm glad they
exist; but I also think they should only be installed when people
explicitly ask for them, because it's quite easy to miss the fact that
you're looking at a manual page which documents POSIX guarantees rather
than your actual system.

-- 
Colin Watson   [cjwat...@ubuntu.com]

-- 
Ubuntu-devel-discuss mailing list
Ubuntu-devel-discuss@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss


Re: man types.h

2013-01-18 Thread Lanoxx


On 18/01/13 14:57, Colin Watson wrote:

On Thu, Jan 17, 2013 at 02:05:47PM +0100, Lanoxx wrote:

On 17/01/13 13:40, Oliver Grawert wrote:

Am Donnerstag, den 17.01.2013, 13:11 +0100 schrieb Lanoxx:

it seems that for solaris there exists a man page for types.h [1] but I
could not find such a man page on ubuntu. Could someone give me a hint,
why it does not exist or is the man page name just different on ubuntu?

the manpage for types.h is in the manpages-posix-dev package, note that
we dont install devleoper documentation by default ...

Thanks, that was what I was looking for. Maybe you can make
manpages-dev recommend this package, so it is automatically
installed if developer manpages are installed?

The one in manpages-posix-dev is not really quite the same.  What that
documents is what POSIX guarantees of sys/types.h, not what the system
provides; so it won't tell you about any system-specific extensions,
some of which might be very important to you (e.g. large file support).

I think manpages-posix(-dev) are useful packages and I'm glad they
exist; but I also think they should only be installed when people
explicitly ask for them, because it's quite easy to miss the fact that
you're looking at a manual page which documents POSIX guarantees rather
than your actual system.

I see you point. Thank you for the explanation.


--
Ubuntu-devel-discuss mailing list
Ubuntu-devel-discuss@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss


Re: man types.h

2013-01-17 Thread Colin Watson
On Thu, Jan 17, 2013 at 01:11:49PM +0100, Lanoxx wrote:
 it seems that for solaris there exists a man page for types.h [1]
 but I could not find such a man page on ubuntu. Could someone give
 me a hint, why it does not exist or is the man page name just
 different on ubuntu?

We don't tend to have manual pages for header files, only for the
functions they contain.  This is arguably a bit awkward for
sys/types.h which doesn't actually contain any functions.

I don't think it's a huge problem, though, since the dominating reason
why you might choose any given type from that header over any other one
would be because of its use in a library function, and there should be
manual pages for all the standard library functions which document the
types they're intended to take.

For documentation of the various system-specific conditional macros used
in sys/types.h, I recommend feature_test_macros(7) (or ftm(7) for
short).

-- 
Colin Watson   [cjwat...@ubuntu.com]

-- 
Ubuntu-devel-discuss mailing list
Ubuntu-devel-discuss@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss


Re: man types.h

2013-01-17 Thread Oliver Grawert
hi,
Am Donnerstag, den 17.01.2013, 13:11 +0100 schrieb Lanoxx:
 Hi,
 
 it seems that for solaris there exists a man page for types.h [1] but I 
 could not find such a man page on ubuntu. Could someone give me a hint, 
 why it does not exist or is the man page name just different on ubuntu?
 
 Regards
 Lanoxx
 
 [1] http://www.unix.com/man-page/opensolaris/3head/types.h/
 
the manpage for types.h is in the manpages-posix-dev package, note that
we dont install devleoper documentation by default ...

ciao
oli


signature.asc
Description: This is a digitally signed message part
-- 
Ubuntu-devel-discuss mailing list
Ubuntu-devel-discuss@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss


Re: man types.h

2013-01-17 Thread Lanoxx


On 17/01/13 13:40, Oliver Grawert wrote:

hi,
Am Donnerstag, den 17.01.2013, 13:11 +0100 schrieb Lanoxx:

Hi,

it seems that for solaris there exists a man page for types.h [1] but I
could not find such a man page on ubuntu. Could someone give me a hint,
why it does not exist or is the man page name just different on ubuntu?

Regards
Lanoxx

[1] http://www.unix.com/man-page/opensolaris/3head/types.h/


the manpage for types.h is in the manpages-posix-dev package, note that
we dont install devleoper documentation by default ...
Thanks, that was what I was looking for. Maybe you can make manpages-dev 
recommend this package, so it is automatically installed if developer 
manpages are installed?


ciao
oli





--
Ubuntu-devel-discuss mailing list
Ubuntu-devel-discuss@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss