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.8 required=5.0 tests=BAYES_00,INVALID_DATE autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,1ff5003422436e4 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 1994-10-15 00:04:48 PST Path: bga.com!news.sprintlink.net!malgudi.oar.net!caen!math.ohio-state.edu!howland.reston.ans.net!pipex!uunet!svc.portal.com!portal!cup.portal.com!R_Tim_Coslet From: R_Tim_Coslet@cup.portal.com Newsgroups: comp.lang.ada Subject: Re: Attractive comments better? Message-ID: <124694@cup.portal.com> Date: Tue, 11 Oct 94 20:19:17 PDT Organization: The Portal System (TM) References: <941005030023_73672.2025_DHR103-1@CompuServe.COM> <36tsda$s32@disunms.epfl.ch> <36u9l3$2bb@gnat.cs.nyu.edu> <37du0k$ir2@gnat.cs.nyu.edu> Date: 1994-10-11T20:19:17-07:00 List-Id: >One important key to writing readable C and C++ programs is to treat headers >as the full equivalent of Ada specs, and comment them appropriately. >Historically, many C programmers treat headers as a kind of annoyance >required by the silly compiler which can't figure it out for itself, >and write the absolute minimum of text in headers with minimal comments. Or worse yet, I've seen a few C programmers actually putting CODE (not just declarations but actual CODE) in some header files! This results in programs that mysteriously grow RAPIDLY in size of executable :-( I couldn't believe it the first time I encountered it, at least Ada simply will NOT let you even attempt this! R. Tim Coslet Usenet: R_Tim_Coslet@cup.portal.com technology, n. domesticated natural phenomena