Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.sys.acorn.programmer > #1218

Re: New C99 Stronghelp manual

Show all headers | View raw

In message <4ef33c77$0$16261$e4fe514c@dreader37.news.xs4all.nl>
          Erik G <erikg@noname.invalid> wrote:

> On 22-12-2011 13:18, Rik Griffin wrote:
> 
> > This is a work in progress, so if you find any errors in content
> > or formatting, in either version, please let me know.
> 
> In the following "SH" refers to the StrongHelp version and "HTML" refers
> to the on-line html version. "Both" refers to both of these versions.
>
> - (SH) Despite the claim on the website, there is no email address to
> report problems in the ReadMe file :-P

Well spotted. My email address is on the title page of the SH manual. I'll
update the readme files for the next release!

> - (Both) Automatically generating the files saves a lot of work, but does
> not compensate for errors or omissions in the original header files.
> E.g.: for assert.h->assert there is no clear description of how the
> NDEBUG macro influences the asserts. (Both)

Very true. Ideally I'll be submitting my modified header files (I added
some simple markup to help extract the info) to ROOL, and then either I or
anyone else can clarify the documentation where required.

> - (SH) Most links in "New features of C99" are empty. As the information
> there is hand-written, this will presumably be filled out later.

Yes I intend to write the rest of that info when I have the time :)

> The use of the "restrict" keyword for function parameters had me puzzled
> for a bit, but some digging in the C99 standard taught me the error of my
> ways ;-). It is a keyword not present in C89 and introduced in C99.

I'll try and add a section on restrict to the "new features" page.

Thanks for the feedback, it's good to know people will find this useful.
And I think a lot of people aren't aware of what C99 offers, hopefully this
will enlighten a few :)

-- 
Rik Griffin
Standard disclaimer, not speaking for anyone but myself, blah blah

Back to comp.sys.acorn.programmer | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

New C99 Stronghelp manual Rik Griffin <nospam@denbridgemarine.com> - 2011-12-22 12:18 +0000
  Re: New C99 Stronghelp manual Erik G <erikg@noname.invalid> - 2011-12-22 15:19 +0100
    Re: New C99 Stronghelp manual Rik Griffin <nospam@denbridgemarine.com> - 2011-12-22 15:12 +0000
      Re: New C99 Stronghelp manual Rick Murray <heyrickmail-usenet@yahoo.co.uk> - 2011-12-23 08:39 +0100
        Re: New C99 Stronghelp manual Chris Johnson <chrisjohnson+news@spamcop.net> - 2011-12-23 10:21 +0000

csiph-web