more documentation for utilities would be cool

Description

Utilities like bro-cut only supply --help documentation, as far as I can tell. Man pages would be handy. (In particular, I was looking for some sort of statement of exactly to what degree bro-cut can munch on the concatenation of multiple log files that have different column layouts.)

Environment

None

Activity

Show:
Robin Sommer
November 24, 2014, 3:27 PM

Daniel, up for integrating these?

Daniel Thayer
December 2, 2014, 3:24 AM

Added these in branch topic/dnthayer/ticket856 in bro, broctl, bro-aux, and trace-summary repos.

Robin Sommer
December 3, 2014, 10:39 PM

Two comments/questions:

  • Daniel, the subprojects install into BRO_MAN_INSTALL_PATH, however that's only set by the top-level (bro) Makefile. It would be nicer if the subprojects didn't depend on that (e.g., trace-summary can be installed standalone as well). I think the better solution would be to adapt each's installation to work on its own.

  • Raúl, would you be ok if we removed the notes that you have written the pages for the Debian project? We usually don't call out individual contributors within the code base, as that's hard to maintain over time as things change. We would instead put your name (and Debian, if you want) into CHANGES.

Raúl Benencia
December 4, 2014, 12:23 PM

Yes, no problems Robin, use the man pages as you wish.

Cheers,
Rul

Daniel Thayer
December 5, 2014, 5:46 PM

These issues have now been addressed.

Assignee

Daniel Thayer

Reporter

Vern Paxson

Labels

None

External issue ID

856

Fix versions

Affects versions

Priority

Normal
Configure