On Mon, Jul 21, 2025 at 10:42:59PM +0200, 'Ralf Hemmecke' via FriCAS - computer
algebra system wrote:
> Dear Waldek,
>
> when I look at your doc-changes, I wonder whether you want to make
>
> ++ Description:
>
> a "keyword" to introduce predocs, i.e. ++ docscring that come before the
> actual object to document. In that case, I would prefer, if SPAD gets closer
> to Aldor in using triple + (+++) as predoc and double + (++) as postdoc.
The issue is different. Top level per constructor documentation part
may contain several fields and they get different handling. Without
field indicator current handling was subtly wrong. If you add
another field, but keep description without field indicater, then
handling becomes badly wrong. We could try to make documentation
processing smarter, to get correct results in such cases. But
ATM I decided to stick to current formatting rules. In particualar
to have field indicator (that is "Description:") for description
field.
I remember you suggestion of using +++. But ATM current code
correctly resolves attachement of ++ comment (that is I am not
aware of any cases of wrong attachement). But there were issues
within toplevel documentatin hunk and I a trying to fix observed
problems.
BTW: The description part normally is last field. I think
some field(s) could go after it, but putting most fields
after description leads to wrong result.
--
Waldek Hebisch
--
You received this message because you are subscribed to the Google Groups
"FriCAS - computer algebra system" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to fricas-devel+unsubscr...@googlegroups.com.
To view this discussion visit
https://groups.google.com/d/msgid/fricas-devel/aH6vXbOMiIX4yllt%40fricas.org.
