Why is documentation of official UDFs missing?

[Melba23]

rindeal,

I have no idea how they were first produced as I was not involved in the process at that time. Nowadays the help file pages for new functions/libraries are written separately from the code - that was certainly the case for my rewrite of Array.au3. As explained earlier, that means we have only the one location to keep up-to-date - and we can add more nicely-formatted explanatory text to the Help file pages.

Of course, most people who write complex UDFs which they post in Examples add "standard" headers - see any of my contributions in my sig for an example - and my UserCallTip Manager within SciTEConfig looks for these headers as a default.

M23

[guinness]

The text files were generated by Gary Frost from a script he created to parse the headers.

[Wiliat87]

Ok, thank you. Case closed.

[guinness]

Great.

[jpm]

  On 3/16/2014 at 6:45 PM, rindeal said:

Why do official UDFs not comply with official UDF standards?

Most of the official UDFs have this:

; #FUNCTION# ====================================================================================================================
; Author ........: randallc, Ultima
; Modified.......: Gary Frost (gafrost), Ultima, Zedna, jpm, Melba23, AZJIO, UEZ
; ===============================================================================================================================

as their documentation. Which also means, do you write the included .chm docs directly? Not by parsing the source files? Or do you just strip it out of the sources before publishing?

Where did you get the link to this "official" page?

I want to update such old pages from 2008 ...

Cheers

Jpm

[guinness]

I can only find it by searching on Google nowadays jpm.

[Melba23]

jpm,

The only link I know if is by Jos in this thread.

M23

[jpm]

Thanks I will update the pointed page.

Cheers

jpm

[czardas]

I have referred to that page many times previously. I found it very helpful at the time. Thank you for updating it.

[jpm]

update done

jpm