Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 30 Jun 2000 14:29:35 +0200
From:      Anders Franzen <uabfra@uab.ericsson.se>
To:        Martin Horcicka <horcicka@dzungle.ms.mff.cuni.cz>
Cc:        freebsd-hackers@FreeBSD.ORG
Subject:   Re: style(9)
Message-ID:  <395C92AF.302B9939@uab.ericsson.se>
References:  <Pine.BSF.3.96.1000630113615.2357A-100000@dzungle.ms.mff.cuni.cz>

next in thread | previous in thread | raw e-mail | index | archive | help
Martin Horcicka wrote:

> Hi,
>
> I'm just reading the style(9) man page and I don't understand to two
> rules:
>
> 1. Citation:
> ============
> The kernel has a name associated with parameter types, e.g., in the kernel
> use:
>
> void    function(int fd);
>
> In header files visible to user land applications, prototypes that are
> visible must use either protected names or no names with the types. It is
> preferable to use protected names. e.g., use:
>
> void    function(int);
>
> or:
>
> void    function(int _fd);
> ============
> Why is that necessary?

IMHO,  I would guess that it can prevent userland from typedefing own types.
I.e. If a program
makes an own type : typedef int fd:

and then includes a header file  saying : void function(int fd):
the compiler would complain about the the type fd.

/Anders Franzen

>
>
> 2. Citation:
> ============
> Indentation is an 8 character tab.  Second level indents are four spaces.
>
> while (cnt < 20)
>         z = a + really + long + statement + that + needs +
>             two lines + gets + indented + four + spaces +
>             on + the + second + and + subsequent + lines.
> ============
> a. What does it mean `second level indents'? Is it the indentation of
>    expressions that cannot fit to one line (as in the example above) or
>    is it any indentation except of the first tab?
>
> b. Aren't 8 characters too many?
>
> Martin
>
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-hackers" in the body of the message



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-hackers" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?395C92AF.302B9939>