Content deleted Content added
Prosfilaes (talk | contribs) |
→Comments: paragraph is too long |
||
Line 342:
* ''10-Nov-2008:'' I was attempting to add more detail for general readers, by adding phrases about the parallel to English--with the commentary notation. Also, the issues about unclosed-comments and nested-comments (comments within commented-out code) are major aspects of comment-syntax design. Noting the "parsing of the language as a [[context-free grammar]]" is a brief note emphasizing that the language design is very much concerned with the compiler. There are also several other aspects that I omitted for brevity; however, I think expanding (not reducing) the text would be a better avenue: adding a whole article section about Ada comment syntax and its impact, where readers would be expecting several sentences about the use of comments. I am thankful for the above analysis: without that suggestion to use fewer words, I might never have realized that many more words were needed. It can be so easy to view other people's concerns as "vacuous" when people forget about viewpoints of beginners or laymen. I have worked on clarifying many articles that people had labeled as "too technical" and needed more basic details for general readers. However, the best approach might be to write an intro article ("[[Introduction to Ada]]") as has been done with other detailed subjects. -[[User:Wikid77|Wikid77]] ([[User talk:Wikid77|talk]]) 15:49, 10 November 2008 (UTC)
* I agree with Macrakis, that this part is too verbose. What should clearly stay is: That the double dash parallels english/natural languages (it’s in the 83 rationale, Section 2.1: ''As an end of line remark, the comment should appear as an explanation of the preceding text -- hence the use of a double hyphen (doing duty for a dash) is natural and appropriate, as illustrated by this sentence.''), and that arbitrary characters are allowed inside comments (this is not invariably true in other languages and explicitly stated in the tinman requirements).
: But the benefits of line comments (no runaway comments, no problems with nesting, grep-friendly, easy to recognize) would IMHO better be elaborated ''in depth'' [[Comment_(computer_programming)|somewhere else]]. However, I ailed to find sources, except internet discussions, for the problems and merits of line and block comments, yet (WP:OR…)—any suggestions where too look for some? [[User:Rathgemz|Rathgemz]] ([[User talk:Rathgemz|talk]]) 22:30, 18 January 2011 (UTC)
== confusing text ==
| |||