Opened 3 months ago

Last modified 12 hours ago

#32306 assigned defect

check-local target to enforce doxygen-correctness

Reported by: nickm Owned by: nickm
Priority: Medium Milestone: Tor: 0.4.3.x-final
Component: Core Tor/Tor Version:
Severity: Normal Keywords: s31-docs, 043-can
Cc: nickm, catalyst Actual Points:
Parent ID: Points:
Reviewer: Sponsor:

Description (last modified by nickm)

We should have a check-local target that makes sure we haven't regressed anything in Doxygen. I'm going to compile a list of what that means here, and then make the target later in November.

Current properties are:

  • Every C and H file (outside of ext, trunnel, and test) should have a @file or \file declaration.
  • @file or \file declarations should match the actual name of the file.
  • There should be no doxygen warnings (except for missing documentation).

Child Tickets

Change History (7)

comment:1 Changed 3 months ago by nickm

Description: modified (diff)

comment:2 Changed 3 months ago by catalyst

Cc: catalyst added

comment:3 Changed 2 months ago by nickm

There should be no doxygen warnings (except for missing documentation).

This part is now handled with --enable-fatal-warnings; see #32385.

comment:4 Changed 2 months ago by nickm

Parent ID: #29214

comment:5 Changed 13 days ago by ahf

Keywords: 043-can added

comment:6 Changed 12 hours ago by gaba

Sponsor: Sponsor31-can

Sponsor closed. Remove from roadmap.

comment:7 Changed 12 hours ago by gaba

Keywords: network-team-roadmap-november removed
Note: See TracTickets for help on using tickets.