From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-0.3 required=5.0 tests=BAYES_00,
	REPLYTO_WITHOUT_TO_CC autolearn=no autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 103376,60e2922351e0e780
X-Google-Attributes: gid103376,public
X-Google-ArrivalTime: 2003-11-11 08:26:28 PST
Path: 
 archiver1.google.com!news2.google.com!fu-berlin.de!uni-berlin.de!adsl-213-200-246-247.cybernet.CH!not-for-mail
From: Vinzent 'Gadget' Hoefler <ada.rocks@jlfencey.com>
Newsgroups: comp.lang.ada
Subject: Re: Clause "with and use"
Date: Tue, 11 Nov 2003 17:24:51 +0100
Organization: JeLlyFish software
Message-ID: <bor2ji$1h7730$2@ID-175126.news.uni-berlin.de>
References: <3FA2CDCB.500F4AF0@fakeaddress.nil>
 <1068123815.335508@master.nyc.kbcfp.com>
 <Duvqb.21219$mB5.927593@news20.bellglobal.com>
 <3FAAB12E.C7593B45@fakeaddress.nil>
 <slrnbqmn3k.pk.randhol+valid_for_reply_from_news@kiuk0156.chembio.ntnu.no>
 <3FACCBFB.9D288CF2@fakeaddress.nil>
 <bebbba07.0311081140.e0e94e6@posting.google.com>
 <slrnbqug4j.ss.randhol+valid_for_reply_from_news@kiuk0156.chembio.ntnu.no>
 <3FAF8C99.5040201@noplace.com>
 <bebbba07.0311102320.7fba665a@posting.google.com>
Reply-To: v.hoefler@acm.org
NNTP-Posting-Host: adsl-213-200-246-247.cybernet.ch (213.200.246.247)
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Trace: news.uni-berlin.de 1068567986 51616864 213.200.246.247 (16 [175126])
X-Newsreader: Forte Agent 1.8/32.548
Xref: archiver1.google.com comp.lang.ada:2360
Date: 2003-11-11T17:24:51+01:00
List-Id: <comp.lang.ada>

Russ wrote:

>I think that's a very good analogy to what you are saying. The
>"context" section at the beginning of nearly every Ada file is like
>the front yard of a home. It's the first thing anyone who reads the
>file sees.

And sees what the house is basically made from?

>If it's unnecessarily cluttered,

it is a bad design. Simple as that.

>people may not complain
>about it, but it will leave a lasting first impression.

You mean, like - for example - the following real world snippet from
the first lines of a main.c?

|/* eventually we have to downgrade the driver */
|#if 0
|#  include <linux/config.h>
|#  include <linux/version.h>
|#endif /*0*/
|
|#include <linux/module.h>    /* for MOD_INC_USE_COUNT, automatic */
|                             /* module or kernel compilation */
|#if 0
|#  include <linux/types.h>
|#  include <linux/fs.h>
|#  include <linux/string.h>
|#  include <linux/ptrace.h>
|#  include <linux/mm.h>     /* for verify_area */
|#  include <linux/malloc.h>
|#  include <linux/errno.h>  /* for -EBUSY */
|#  include <linux/ioport.h> /* for check_region, request_region */
|#  include <linux/delay.h>  /* for loops_per_sec */
|#  include <asm/segment.h>  /* for put_user_byte */
|#  include <asm/io.h>       /* for inb_p, outb_p, inb, outb, etc. */
|#endif /*0*/
|
|#include <asm/uaccess.h>    /* for get_user, copy_from_user, etc. */
|
|#if 0
|#  include <linux/wait.h>       /* for wait_queue */
|#  include <linux/poll.h>       /* for POLLING, etc. */
|#  include <linux/miscdevice.h> /* for miscdevice */
|#endif /*0*/
|
|#include <linux/proc_fs.h>           /* for procfs functions */
|#include <linux/devfs_fs_kernel.h> /* for devfs functions */
|#include <linux/pci.h>             /* for new pci functions */
|
|#if 0
|#  include <linux/time.h>
|#  include <linux/timer.h>
|#  include <linux/delay.h>
|#endif /*0*/
|
|#if (LINUX_VERSION_CODE >=3D 131343)
|#  include <linux/init.h> /* for __init, module_{init,exit}; */
|                          /* automatic freeing of kernel code after */
|                          /* booting/loading */
|#else
|#  define __init
|#  define __initdata
|#endif

I won't tell you about the difference, but you can surely do that for
me. :->


Vinzent.