Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Mailing lists / lazarus / 2021-01

FPDoc chms and code examples - second thread

1 message · 1 person ·

Reply by email Subscribe to this list Your subscription

Read-only archive. Use j and k to move between messages.

Andrey Sobol

Oh sorry, I send my message into another thread :(

I opened the topic about short code examples that should be embedded in the documentation. About the full examples I know.

Also I and Trevor have wrote a readme.txt file for those directories: The file you can read here:
https://drive.google.com/file/d/1wHiM-UMClcjvmBLj1PQDwwQ4sNKdXl79/view?usp=sharing

Me personally prefer to place short code snippets into help pages, with some syntax highlight. Also, big code samples can be made as separate

help

Show quoted text 10 lines
(html) files, with detailed description. Same as in Wiki. Pure code examples can be found in lazarus/examples directory, they even have browser, embedded in IDE (create project, browse samples). On Fri, Jan 15, 2021, 10:53 Andrey Sobol via lazarus < > wrote: > Hello, > I see that nobody used to a tag <examples> for creating

documentation lcl,

Show quoted text 19 lines
> lazutil. That tag is used only the fpc team. > I have read a documentation and saw rtl .xml`s and so. > I want to create a directory for used examples of code as : > > - lazarus/doc/exlcl > - lazarus/doc/exlazutil > > and put inside files in notation with dots. For example: > fileutil.findallfiles.pas (I think it will be convenient) > > + readme.txt (into those directories) > + wiki descriptions about it. > > I have checked it, a html`s works and a chm`s too. > > What is yours opinion about it? > And how to create directory, also by patch? > > Andrey Sobol.--

Andrey

Andrey

Reply by email