Page 1 of 1

Mistakes in the documentation

PostPosted: Wed Dec 05, 2018 7:38 am
by Alpyre
I've encountered some mistakes as I go through the documentation and noted them down. Here they are for your attention:
Code: Select all
application.doc:
  - Identifiers READPREFS_LastAppDocs,
                WRITEPREFS_LastAppDocs,
                REGAPP_Name
  ...are explained but they are not defined in the headers.

  - a typedef c_time is mentioned but not defined in the headers.

  - AppLibMsg and AppLibOpenPrintDocMsg structs are mentioned but not defined
    in the headers.

intuition.doc:
  WA_Flags is not mentioned in SetWindowAttr

bsdsocket.doc:
  - Error identifier EACCES is misspelled as EACCESS (many times)
  - SIOCSIFADDR is misspelled as SIOCIFADDR
  - BIOCSETIF is misspelled as BIOSETIF
  - IFNAMSIZ is misspelled as IFNAMSIZE

Re: Mistakes in the documentation

PostPosted: Wed Dec 05, 2018 3:26 pm
by broadblues
Alpyre wrote:I've encountered some mistakes as I go through the documentation and noted them down. Here they are for your attention:
application.doc:
- Identifiers READPREFS_LastAppDocs,
WRITEPREFS_LastAppDocs,
REGAPP_Name
...are explained but they are not defined in the headers.

- a typedef c_time is mentioned but not defined in the headers.

- AppLibMsg and AppLibOpenPrintDocMsg structs are mentioned but not defined
in the headers.


With the exception of #?PRESF_LastApppDoc these seam already addressed in the docs, it may be that the lastAppDocs is not implmented yet (not sure what it means TBH).
intuition.doc:
WA_Flags is not mentioned in SetWindowAttr


It's not an error, WA_Flags is not support by SetWindowAttrs(), only by GetWindowAttrs().
bsdsocket.doc:
- Error identifier EACCES is misspelled as EACCESS (many times)
- SIOCSIFADDR is misspelled as SIOCIFADDR
- BIOCSETIF is misspelled as BIOSETIF
- IFNAMSIZ is misspelled as IFNAMSIZE


I'll leave those for someone else (with more knowledge) to comment on