There may be a way not to reinvent the wheel and also maintain some use previous use cases other patchers and developers have used.

Consider e.g. the reflection classes in purr data, like [canvasinfo], which has a [dir( method.

Likewise pddp/pddplink etc. can open files in the native OS, and they are used a ton in documentation for externals, for instance.

I'm not saying that either of these specifically needs to be included in vanilla, but these are problems that have already been solved in various ways and it could be worthwhile to see what exists.

On Sun, Jun 30, 2019 at 9:44 PM Miller Puckette <msp@ucsd.edu> wrote:

The gotcha is that I can't find a way to typeset equations in native HTML...
and properly documenting even osc~ is going to require some.

Perhaps it would work to have basic doc in HTML and detailed doc (theory of
operation level stuff) in either markdown or latex.

cheers
M

On Mon, Jul 01, 2019 at 01:22:40AM +0000, Lucas Cordiviola wrote:
> On 6/30/2019 1:05 AM, Miller Puckette wrote:
>
> > Any advice would be very helpful!
>
>
> Stay in the HTML format.
>
> Following https://www.w3schools.com/html/html_basic.asp anyone can come
> up with an object documentation.
>
> HTML is the way to go. No need for latex, md, or whatever. HTML is
> really simple and works on any computer and is very straightforward to
> maintain and enhance. Most importantly it does not add compiling dependency.
>
> *************************************
>
> <!DOCTYPE html>
> <html>
> <head>
> </head>
> <body>
>
> <h1> big heading </h1>
> <h2> h2 smaller heading </h2>
>
> <p> paragraph
>
> <p> paragraph 2
>
> </body>
> </html>
>
> *********************************
>
>
> Having the ability to open local or remote URLs?? is a total Pd enhancer.
>
>
> :)
>
>
> Mensaje telepatico asistido por maquinas.
>

_______________________________________________
Pd-dev mailing list
Pd-dev@lists.iem.at
https://lists.puredata.info/listinfo/pd-dev