Re: [tor-bugs] #32306 [Core Tor/Tor]: check-local target to enforce doxygen-correctness

[Tor Bug Tracker & Wiki]

#32306: check-local target to enforce doxygen-correctness
--+
 Reporter:  nickm |  Owner:  nickm
 Type:  defect| Status:  assigned
 Priority:  Medium|  Milestone:  Tor: 0.4.4.x-final
Component:  Core Tor/Tor  |Version:
 Severity:  Normal| Resolution:
 Keywords:  s31-docs 044-can  |  Actual Points:
Parent ID:| Points:
 Reviewer:|Sponsor:
--+
Changes (by nickm):

 * keywords:  s31-docs, 043-can => s31-docs 044-can


--
Ticket URL: 
Tor Bug Tracker & Wiki 
The Tor Project: anonymity online
___
tor-bugs mailing list
tor-bugs@lists.torproject.org
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs

Re: [tor-bugs] #32306 [Core Tor/Tor]: check-local target to enforce doxygen-correctness

[Tor Bug Tracker & Wiki]

#32306: check-local target to enforce doxygen-correctness
-+-
 Reporter:  nickm|  Owner:  nickm
 Type:  defect   | Status:
 |  assigned
 Priority:  Medium   |  Milestone:  Tor:
 |  0.4.3.x-final
Component:  Core Tor/Tor |Version:
 Severity:  Normal   | Resolution:
 Keywords:  network-team-roadmap-november,   |  Actual Points:
  s31-docs, 043-can  |
Parent ID:   | Points:
 Reviewer:   |Sponsor:
 |  Sponsor31-can
-+-
Changes (by ahf):

 * keywords:  network-team-roadmap-november, s31-docs => network-team-
 roadmap-november, s31-docs, 043-can


--
Ticket URL: 
Tor Bug Tracker & Wiki 
The Tor Project: anonymity online
___
tor-bugs mailing list
tor-bugs@lists.torproject.org
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs

Re: [tor-bugs] #32306 [Core Tor/Tor]: check-local target to enforce doxygen-correctness

[Tor Bug Tracker & Wiki]

#32306: check-local target to enforce doxygen-correctness
-+-
 Reporter:  nickm|  Owner:  nickm
 Type:  defect   | Status:
 |  assigned
 Priority:  Medium   |  Milestone:  Tor:
 |  0.4.3.x-final
Component:  Core Tor/Tor |Version:
 Severity:  Normal   | Resolution:
 Keywords:  network-team-roadmap-november,   |  Actual Points:
  s31-docs   |
Parent ID:   | Points:
 Reviewer:   |Sponsor:
 |  Sponsor31-can
-+-
Changes (by nickm):

 * parent:  #29214 =>


--
Ticket URL: 
Tor Bug Tracker & Wiki 
The Tor Project: anonymity online
___
tor-bugs mailing list
tor-bugs@lists.torproject.org
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs

Re: [tor-bugs] #32306 [Core Tor/Tor]: check-local target to enforce doxygen-correctness

[Tor Bug Tracker & Wiki]

#32306: check-local target to enforce doxygen-correctness
-+-
 Reporter:  nickm|  Owner:  nickm
 Type:  defect   | Status:
 |  assigned
 Priority:  Medium   |  Milestone:  Tor:
 |  0.4.3.x-final
Component:  Core Tor/Tor |Version:
 Severity:  Normal   | Resolution:
 Keywords:  network-team-roadmap-november,   |  Actual Points:
  s31-docs   |
Parent ID:  #29214   | Points:
 Reviewer:   |Sponsor:
 |  Sponsor31-can
-+-

Comment (by nickm):

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

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

--
Ticket URL: 
Tor Bug Tracker & Wiki 
The Tor Project: anonymity online
___
tor-bugs mailing list
tor-bugs@lists.torproject.org
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs

Re: [tor-bugs] #32306 [Core Tor/Tor]: check-local target to enforce doxygen-correctness

[Tor Bug Tracker & Wiki]

#32306: check-local target to enforce doxygen-correctness
-+-
 Reporter:  nickm|  Owner:  nickm
 Type:  defect   | Status:
 |  assigned
 Priority:  Medium   |  Milestone:  Tor:
 |  0.4.3.x-final
Component:  Core Tor/Tor |Version:
 Severity:  Normal   | Resolution:
 Keywords:  network-team-roadmap-november,   |  Actual Points:
  s31-docs   |
Parent ID:  #29214   | Points:
 Reviewer:   |Sponsor:
 |  Sponsor31-can
-+-
Description changed by nickm:

Old description:

> 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.
>   * There should be no doxygen warnings (except for missing
> documentation).

New description:

 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).

--

--
Ticket URL: 
Tor Bug Tracker & Wiki 
The Tor Project: anonymity online
___
tor-bugs mailing list
tor-bugs@lists.torproject.org
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs