9fans - fans of the OS Plan 9 from Bell Labs
 help / color / mirror / Atom feed
From: "Devon H. O'Dell" <devon.odell@gmail.com>
To: "Fans of the OS Plan 9 from Bell Labs" <9fans@cse.psu.edu>
Subject: Re: [9fans] Function args not checked
Date: Mon, 17 Apr 2006 09:00:33 -0700	[thread overview]
Message-ID: <9ab217670604170900o62544233r59b8a9a504a656f6@mail.gmail.com> (raw)
In-Reply-To: <4443BA0C.3020300@comtv.ru>

2006/4/17, Victor Nazarov <vir@comtv.ru>:
> jmk@plan9.bell-labs.com wrote:
>
> >As an aside, when you declare prototypes I find it is best to
> >only give the types of the parameters and not declare identifiers,
> >e.g.
> >       extern Elem mkoid(Ints *); // asn1.h
> >rather than
> >       extern Elem mkoid(Ints *oid); // asn1.h
> >This prevents confusion in environments where there is overuse
> >of the pre-processor and the identifier gets substituted.
> >
> >
> It's just an evidence of preprocessor's danger. Let's use enums. IMHO,
> prototypes are quite good documentation sometimes.

Until someone reorders arguments and forgets to update the prototype
to reflect them. Using argument names in your prototypes is not an
excuse to not write documentation on your API. It is an excuse to be
lazy.

--Devon

> --
> Victor Nazarov
>
>


      reply	other threads:[~2006-04-17 16:00 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2006-04-17  6:50 Rodolfo (kix)
2006-04-17  7:00 ` geoff
2006-04-17  7:25   ` Rodolfo (kix)
2006-04-17 14:52 ` jmk
2006-04-17 15:17   ` "Nils O. Selåsdal"
2006-04-17 15:28     ` David Leimbach
2006-04-17 15:31       ` jmk
2006-04-17 15:40         ` Paul Lalonde
2006-04-17 16:30           ` Skip Tavakkolian
2006-04-17 20:43             ` Don Bailey
2006-04-17 15:53   ` Victor Nazarov
2006-04-17 16:00     ` Devon H. O'Dell [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=9ab217670604170900o62544233r59b8a9a504a656f6@mail.gmail.com \
    --to=devon.odell@gmail.com \
    --cc=9fans@cse.psu.edu \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).