View Issue Details

IDProjectCategoryView StatusLast Update
0006364Talerlibeufin (general)public2023-11-03 10:23
ReporterMS Assigned To 
PrioritynoneSeveritytextReproducibilityhave not tried
Status newResolutionopen 
Product Versiongit (master) 
Target Versionpost-1.0 
Summary0006364: Comments style.
DescriptionFrom a private conversation:

I've seen that some comments in LibEuFin use the

/**
 * foo
 * bar
 */

style. While this is not really a big issue, I just wanted to mention
that comments beginning with "/**" usually indicate doc comments. That
is, comments that are relevant to the documentation generator (doxygen,
dokka, ...).

As such, it's better style to use "//" comments or "/*" comments (single
start) for comments that just explain what's going on inside the code,
as opposed to comments that represent the documentation for some
"documentable" element, such as functions, class members, etc.
TagsNo tags attached.

Activities

There are no notes attached to this issue.

Issue History

Date Modified Username Field Change
2020-06-04 16:37 MS New Issue
2020-11-10 12:18 MS Target Version => 0.9.3
2023-01-08 11:23 Christian Grothoff Target Version 0.9.3 => 0.9.6
2023-04-13 20:29 Florian Dold Project libeufin => Taler
2023-04-13 21:46 Florian Dold Category other => libeufin (general)
2023-11-03 10:23 Christian Grothoff Product Version => git (master)
2023-11-03 10:23 Christian Grothoff Target Version 0.9.6 => post-1.0