Re: [boost] graph library questions

From: Greg Colvin (gcolvin_at_[hidden])
Date: 2000-09-29 13:17:22

From: Beman Dawes <beman_at_[hidden]>
> At 12:14 PM 9/29/2000 -0400, David Abrahams wrote:
>  >
>  >>  > I tried to find some of the answers by going through the source 
> code,
>  >>  > but as I am just getting familiar with STL, it is a daunting task at
>  >>  > the moment :-)
>  >>
>  >> Some of these answers are in the new HTML documentation. I'll also
>  >> be filling in the docs more (especially with answers that I give
>  >> to email questions).
>  >>
>  >> http://www.boost.org/libs/graph/docs/adjacency_list.html
>  >> and
>  >> http://www.boost.org/libs/graph/docs/using_adjacency_list.html
>  >
>  >That's great, but we should also get a lot more commentary into the code
>  >itself, especially if the hope is to pass maintenance responsibility on
>  >someday.
> 
> I've been trying something in some industrial code I maintain that seems to 
> be useful:
> 
> In the C++ source file, I include comments like:
> 
>      do_adjacency_list_func(); // See docs/adjacency_list.html
> 
> I wrote a little VC++ plugin that invokes any selected text as a 
> command.  So you select docs/adjacency_list.html, and click the plugin's 
> toolbar icon, and the browser starts, displaying docs/adjacency_list.html.
> 
> Now if IDE vendors would just start building that functionality into their 
> source editors...

Borland had it in circa '90, and Apple had in the Macintosh
Progammmers Workbench even before that.  And then there is emacs ...