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=-1.9 required=5.0 tests=BAYES_00
	autolearn=unavailable autolearn_force=no version=3.4.4
Path: 
 eternal-september.org!reader01.eternal-september.org!.POSTED!not-for-mail
From: Paul Rubin <no.email@nospam.invalid>
Newsgroups: comp.lang.ada
Subject: Re: Why .ads as well as .adb?
Date: Sat, 08 Jun 2019 17:40:31 -0700
Organization: A noiseless patient Spider
Message-ID: <87y32bvbeo.fsf@nightsong.com>
References: <28facad3-c55f-4ef2-8ef8-004925b7d1f1@googlegroups.com>
	<qcvqut$ejh$1@gioia.aioe.org>
	<dbbcf7b1-091f-4c87-b2b1-021bb9503b70@googlegroups.com>
	<qd2krk$pin$1@gioia.aioe.org>
	<f37f6f75-62d4-4152-917e-d666d67f6cb7@googlegroups.com>
	<qd6rb8$hl7$1@franka.jacob-sparre.dk>
	<a902e41a-729d-4c00-8e3f-0cda1822a349@googlegroups.com>
	<qd81gq$aej$1@dont-email.me> <87woi0xtwm.fsf@nightsong.com>
	<glpiqeFt9jqU1@mid.individual.net>
	<f611bdb8-5a40-48bd-afe5-17de72bbe193@googlegroups.com>
	<glq1rpF1v52U1@mid.individual.net>
	<4a0438de-1f1d-4469-aae4-908854d378ea@googlegroups.com>
	<qdbvth$3db$1@franka.jacob-sparre.dk>
	<47d02bdc-6b50-43aa-bc5d-bb5b6225f5bd@googlegroups.com>
	<455333f0-ede4-4833-900a-240a499395ac@googlegroups.com>
	<875zphvufc.fsf@nightsong.com> <ln1s03sqkt.fsf@kst-u.example.com>
Mime-Version: 1.0
Content-Type: text/plain
Injection-Info: reader02.eternal-september.org;
 posting-host="c94d176a6ea1d57d23efb185ccb2a0e8";
	logging-data="13503"; mail-complaints-to="abuse@eternal-september.org";
	posting-account="U2FsdGVkX19XhweYs/BtwNTuk8PfPN4i"
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.3 (gnu/linux)
Cancel-Lock: sha1:/7Pqf3SFExvGvRgF2Z3hl1IW+gk=
	sha1:33d7Qa3hlp5JcY9qhc1n63jkEW0=
Xref: reader01.eternal-september.org comp.lang.ada:56569
Date: 2019-06-08T17:40:31-07:00
List-Id: <comp.lang.ada>

Keith Thompson <kst-u@mib.org> writes:
> Math textbooks have a table of contents and an index.  Both *could* be
> in separate volumes, but there would be no particular advantage in that
> (though it's entirely possible that the author kept them in separate
> files).

Sure, that's a good comparison.  Actually typically, the TOC and index
are generated by software using inline markers that the author puts in
the text.  There might be an occasional situation where you want the TOC
and the main text to be in separate volumes (like for a 100 volume
series you could want a special volume just for the TOC), but normally
it's fine to print both in the same volume.

So it still seems annoying to requires the spec and body to be in
separate files.

Also in Java, I thought that top level class definitions were required
to be in separate files.  At least I've always seen it done that way,
and it makes it much harder to browse the code IME.  I like file sizes
that are small enough to conveniently browse but that have enough
content to keep me occupied without having to switch around between
files.  In practice that means maybe 10 to 30 screens, depending.