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=ham autolearn_force=no version=3.4.4 X-Google-Thread: 103376,8e11100f675ea2df X-Google-NewGroupId: yes X-Google-Attributes: gida07f3367d7,domainid0,public,usenet X-Google-Language: ENGLISH,ASCII-7-bit X-Received: by 10.66.82.103 with SMTP id h7mr8149467pay.11.1357240045650; Thu, 03 Jan 2013 11:07:25 -0800 (PST) Path: 6ni79766pbd.1!nntp.google.com!news.glorb.com!border3.nntp.dca.giganews.com!Xl.tags.giganews.com!border1.nntp.dca.giganews.com!nntp.giganews.com!local2.nntp.dca.giganews.com!nntp.earthlink.com!news.earthlink.com.POSTED!not-for-mail NNTP-Posting-Date: Thu, 03 Jan 2013 13:07:24 -0600 Date: Thu, 03 Jan 2013 11:01:18 -0800 From: Charles Hixson User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:10.0.11) Gecko/20121122 Icedove/10.0.11 MIME-Version: 1.0 Newsgroups: comp.lang.ada Subject: Re: asynchronous task communication References: <1c2dnd5E6PMDR33NnZ2dnUVZ_sednZ2d@earthlink.com> <50e18094$0$6583$9b4e6d93@newsspool3.arcor-online.net> <7NednS4s2oukfXzNnZ2dnUVZ_oadnZ2d@earthlink.com> <7cudnYloBfQDw3_NnZ2dnUVZ_rKdnZ2d@earthlink.com> <6bqdndEYjoxeGHnNnZ2dnUVZ_sadnZ2d@earthlink.com> <4u2fqbijm0ur.1pbknoccr8hqb.dlg@40tude.net> In-Reply-To: <4u2fqbijm0ur.1pbknoccr8hqb.dlg@40tude.net> Message-ID: X-Usenet-Provider: http://www.giganews.com NNTP-Posting-Host: 216.244.16.210 X-Trace: sv3-N5rsgiWIdvwboKUlnYmLWM/nHRKSFvmoMhrKhJrScOx/xgzlmB0Xsi2QUhb+t4scFCYTU+QlavRH+Bb!HrgFdfz5El1R54hXFKmBaCgJ7gWwPsndZTyLoCDpDAm58jr+LuNL7V4ZgZPYZfAVwJ9u9HnLLIlt!oogPP5pX1jVlCiiE2NhDrg== X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint properly X-Postfilter: 1.3.40 X-Original-Bytes: 4915 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Date: 2013-01-03T11:01:18-08:00 List-Id: On 01/03/2013 12:50 AM, Dmitry A. Kazakov wrote: > On Wed, 02 Jan 2013 16:20:11 -0800, Charles Hixson wrote: > >> On 01/02/2013 12:35 PM, Dmitry A. Kazakov wrote: > >>> You make node a discriminated record type. Usually when a node is created >>> it is already known how many children and/or parents it will have. E.g. > >> That's not true in this case. The node adds references depending on the >> data that it encounters. > > OK, that does not look like NN. > >> Even the "base layer", such as it is, isn't >> allocated all at once, but only as appropriate stimuli arrive. > > That looks like a design choice. Why should it be this way? I mean, it is > not a RT system, but anyway this kind of allocation policy would inflict > heavy latencies at least initially. It may have sense only if you had a > huge number of nodes of which only a minor part were actually involved in > actual computations. Such loosely coupled systems are not very common. Well, it's a design choice, but it's one driven by circumstance. The number of possible input stimuli is exceedingly large. Basically it's the set of space delimited strings of characters that it could encounter...that's not quite right, and the final decision of what the input will be is still being thought about, but that's about what it is. I'm contemplating how to deal with non-ASCII chars, and with punctuation both internally and terminally, but almost all of the input is english text. Even if I used unicode chars as the basic stimulus, though (more flexible, but LOTS more processing required) there would still be more possible inputs than I would want to pre-allocate, and most of them would never show up. But some would. There are occasional Greek, Hindi, and Chinese words or characters, though embedded in English text. And I can't say that something I haven't thought of won't show up soon. Musical notation, perhaps (if that can be done in unicode). > >>> By hands. I write docs manually. It is tedious, I admit. Consider it as an >>> extra code review step, helps finding inconsistencies and gaps which >>> otherwise slip through. >> In my experience, code that's documented that way tends to have >> documentation that's incomplete, out of date, or both. > > That depends. I consider documentation as an integral part of the process. > I never release/update anything without documenting it first. > > Generated documentation is a chaotic collection of comments you once wrote > around declarations. If you don't write/update them no tool could fix that. > There's more that one purpose for documentation. What the documentation should be depends on who it's directed at. I've written user manuals for programs (that I've written), and they don't mention ANY of the internals, but developer documentation NEEDS those comments, yet it needs to be compact enough that it doesn't take up too much screen space. And library user documentation (which is what AdaBrowse can generate) is yet something else again. For my current needs, developer documentation, it's looking as if NaturalDocs will fill the bill.