Most every C file needs a doxygen @file declaration

Doxygen does not generate any documentation for files that do not say @file or \file. We have dozens of those right now.

changed milestone to %Tor: 0.4.3.x-final

Trac:
Parent Ticket: #29214 (moved)

added actualpoints::.1 component::core tor/tor milestone::Tor: 0.4.3.x-final network-team-roadmap-november owner::nickm parent::29214 points::.1 priority::medium resolution::fixed reviewer::dgoulet s31-docs severity::normal sponsor::31-can status::closed type::defect labels

See #32306 (moved) for a ticket about writing rules to enforce this.

This is a comments-only set of changes, affecting doxygen output. There were about 130 files that doxygen was ignoring!

See branch ticket32308 with PR in https://github.com/torproject/tor/pull/1476 .

I'm not sure whether this meets the threshold for what I might merge without review; it does seem a little larger than is intended by "editorial fixes" on our merge policy.

Some of the per-file documentation I added here could stand to be more verbose. If it's okay with the reviewer, I'd like to have a separate tickets about that. Without this minimal per-file documentation, all of the member documentation in each file remains ignored by Doxygen.

Trac:
Status: assigned to needs_review
Actualpoints: N/A to .1

ack!

Trac:
Status: needs_review to merge_ready
Reviewer: N/A to dgoulet

Merged!

Trac:
Resolution: N/A to fixed
Status: merge_ready to closed

Trac:
Parent: #32306 (moved) to #29214 (moved)

closed

changed time estimate to 48m

added 48m of time spent

mentioned in issue #29214 (moved)

moved to tpo/core/tor#32307 (closed)