View Issue Details

IDProjectCategoryView StatusLast Update
0006364Talerlibeufin (general)public2026-09-19 14:42
ReporterMS Assigned ToFlorian Dold Resolution deadline
ImplementerReviewer 
Release signed byDeployed by 
VerifierCommunicator 
Data protection authority notification requiredNo  
CSIRT notification requiredNo  
Estimated effort (hours)Actual effort (hours)0 
Fast-trackNo
Work packagenone
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

Required notifications

Address or linkRemarkAdded byNotifiedActions

Activities

Florian Dold

2026-08-29 22:51

manager   ~0029779

I think this is stale.

Issue History

Date ModifiedUsernameFieldChange
2020-06-04 14:37MSNew Issue
2020-11-10 11:18MSTarget Version => 0.9.3
2023-01-08 10:23Christian GrothoffTarget Version0.9.3 => 0.11
2023-04-13 18:29Florian DoldProjectlibeufin => Taler
2023-04-13 19:46Florian DoldCategoryother => libeufin (general)
2023-11-03 09:23Christian GrothoffProduct Version => git (master)
2023-11-03 09:23Christian GrothoffTarget Version0.11 => post-1.0
2025-06-08 18:20Christian GrothoffTag Attached: debt
2026-02-16 22:46Christian GrothoffStatusnew => implementing
2026-08-29 22:51Florian DoldAssigned To => Florian Dold
2026-08-29 22:51Florian DoldStatusimplementing => closed
2026-08-29 22:51Florian DoldResolutionopen => no change required
2026-08-29 22:51Florian DoldNote Added: 0029779
2026-09-19 14:42Christian GrothoffFixed in Version => 1.6
2026-09-19 14:42Christian GrothoffTarget Versionpost-1.0 => 1.6