Re: A doubt about Doxygen style comments in GLOBAL

Hi Simon,

2015-06-17 0:05 GMT+09:00 Simon D. <[email protected]>:
> I admit I was adding some extra (hopefully helpful) notes to some of
> your comments as if the source code wasn't available.
> E.g. "mkdir() creates the directory in mode 0775, if doesn't exist."
> in htags.c [make_directory_in_distpath()].
> Do you want them removing?

It is no problem.

> > If they mislead Doxygen, '/**' should be changed to '/*'.
> > What do you think?
>
> Yes, that's OK.  But do you think we should add a text marker to the
> '/*' ones, so some unknowing programmer doesn't add the '*' back by
> mistake?

I think it isn't necessary. For C source code, both '/*' and '/**' are
correct.

> Do you want the '@code...@endcode', '@note', '@remark', '@warning'
> and '@attention' sections leaving in?
>  (see: makepath(), makedirectories(), libutil/gtagsop.c)
>
> Or do I:
>  remove '@code' and '@endcode' lines,
>  change '@note' into 'Note:',
>  change '@remark' into 'Remark:',
>  change '@warning' into 'Warning:',
>  change '@attention' into 'Attention:'?

It's my job. I'm sorry that I couldn't utilize your work.

Regards,
Shigio
-- 
Shigio YAMAGUCHI <[email protected]>
PGP fingerprint: D1CB 0B89 B346 4AB6 5663  C4B6 3CA5 BBB3 57BE DDA3

_______________________________________________
Bug-global mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/bug-global