We've got two cases where it would be very useful to be able to easily
extract the library name from a header file:
* Generating a dependency analysis based on library names rather than than
header names.
* Reporting problems (tabs in files, etc.) with an automatic scanning tool.
We currently have a guideline that source files include a comment in the
form:
// See http://www.boost.org for updates, documentation, ...
I'd like to propose changing that (particularly for headers) to:
// See http://www.boost.org/library-name for documentation.
and require that it be the first instance of "http://www.boost.org/" in a
source file.
That will make it easy to associate a header with the library it belongs
to, and may also help users reach documentation quickly.
Comments?
--Beman
_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
- Re: [boost] Proposal: Identifying libraries Beman Dawes
- Re: [boost] Proposal: Identifying libraries Douglas Gregor
- Re: [boost] Proposal: Identifying libraries Beman Dawes
- Re: [boost] Proposal: Identifying libraries Peter Dimov
- Re: [boost] Proposal: Identifying librarie... Beman Dawes
- Re: [boost] Proposal: Identifying lib... Peter Dimov
- Re: [boost] Proposal: Identifying... Beman Dawes
- [boost] Re: Proposal: Identifying libraries Edward Diener
- Re: [boost] Re: Proposal: Identifying libraries Beman Dawes
- [boost] Re: Re: Proposal: Identifying librarie... Edward Diener