FLTK logo

Re: [fltk.coredev] Re: fl_arc() doc improvement?

FLTK matrix user chat room
(using Element browser app)   FLTK gitter user chat room   GitHub FLTK Project   FLTK News RSS Feed  
  FLTK Library      Forums      Links      Apps     Login 
[  All Forums  |  Back to fltk.coredev  ]
 
[ Previous Message ] [ New Message | Reply ] [ Next Message ]

Re: Re: fl_arc() doc improvement? Greg Ercolano 12:37 Aug 29  
 

On 8/29/26 09:32, 'Albrecht Schlosser' via fltk.coredev wrote:

On 8/29/26 18:06 Greg Ercolano wrote:
    To redo the doxygen docs, perhaps there's an \include technique of some kind so the docs from elsewhere get pulled in to that same location, avoiding duplicate docs.

Yep, there is (for instance) `\include{doc}` which we already use, but IIRC that requires an entire file to be included.
[..]
If we wanted to include some documentation details in more than one place, then we'd have to add one file for each piece of docs (AFAICT). That doesn't make it easier to maintain.

    Yeah, that's what I feared, but I thought maaaaybe there was a way to bracket sections, give them a single name, and then \include that, pulling in a copy of all that text.

    From what I can tell, a possible route is to use @defgroup in the "Drawing Things" section, and then pull in the function/method docs by using @addtogroup <some_name> and then use @{ and @} to bracket them for capture by the "Drawing Things" section.

    Or something like that.

    Otherwise, I guess we just leave it as is, maintaining duplicate docs, as I don't think we want to dump the "drawing things" section..

--
You received this message because you are subscribed to the Google Groups "fltk.coredev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to fltkcoredev+unsubscribe@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/fltkcoredev/90b085a4-6557-4ca4-b291-edd1fa0b9a14%40seriss.com.
[ Direct Link to Message ]
 
     
[ Previous Message ] [ New Message | Reply ] [ Next Message ]
 
 

Comments are owned by the poster. All other content is copyright 1998-2026 by Bill Spitzak and others. This project is hosted by The FLTK Team. Please report site problems to 'erco@seriss.com'.