View Issue Details

IDProjectCategoryView StatusLast Update
0006364Talerlibeufin (general)public2026-09-19 16:42
ReporterMS Assigned ToFlorian Dold  
PrioritynoneSeveritytextReproducibilityhave not tried
Status closedResolutionno change required 
Product Versiongit (master) 
Target Version1.6Fixed in Version1.6 
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.
Tagsdebt

Activities

Florian Dold

2026-08-30 00:51

manager   ~0029779

I think this is stale.

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.11
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.11 => post-1.0
2025-06-08 20:20 Christian Grothoff Tag Attached: debt
2026-02-16 23:46 Christian Grothoff Status new => confirmed
2026-08-30 00:51 Florian Dold Assigned To => Florian Dold
2026-08-30 00:51 Florian Dold Status confirmed => closed
2026-08-30 00:51 Florian Dold Resolution open => no change required
2026-08-30 00:51 Florian Dold Note Added: 0029779
2026-09-19 16:42 Christian Grothoff Fixed in Version => 1.6
2026-09-19 16:42 Christian Grothoff Target Version post-1.0 => 1.6