Skip to Content.
Sympa Menu

sm-discuss - Re: [SM-Discuss] Attracting new developers

sm-discuss AT lists.ibiblio.org

Subject: Public SourceMage Discussion List

List archive

Chronological Thread  
  • From: Dufflebunk <dufflebunk AT dufflebunk.homeip.net>
  • To: Seth Woolley <seth AT tautology.org>
  • Cc: David Kowis <dkowis+smdiscuss AT shlrm.org>, "Eric D. Schabell M.Sc" <projectlead AT sourcemage.org>, Dufflebunk <dufflebunk AT go-nix.ca>, sm-discuss <sm-discuss AT lists.ibiblio.org>
  • Subject: Re: [SM-Discuss] Attracting new developers
  • Date: Fri, 05 Sep 2003 21:19:10 -0000

Would anyone find it useful to have hyperlinked sources? Where you open
the script in a browser and all the function calls (or more likely just
a simple word search rather than full parsing to figure out what is a
function call and what is a string) are links to the definition of the
function?

Using the *.func files, this would be fairly easy to add to the
documentation generation.

On Fri, 2003-09-05 at 15:16, Seth Woolley wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> We can make a manual section for our API and use bashdoc to dynamically
> generate new man pages every night and I can publish it from something
> like this:
>
> http://smgl.positivism.org/bin/misc/man.cgi
>
> Mine will auto-cross-link as well if a man page exists for a word used, so
> combined with this bashdoc.sh program, we can have auto-generating man
> pages in the end hopefully with full API description. Whether to have API
> be a separate section from user docs is another matter -- they could be
> combined. Right now I have pulled the wiki into man pages for example:
>
> http://smgl.positivism.org/bin/misc/man.cgi/wiki/SourceMageWiki
>
> http://smgl.positivism.org/music/wiki/man/
> (the wiki crawling bot I wrote was a bit too aggressive)
> http://smgl.positivism.org/music/wiki/
> (raw wiki pages grabbed by the bot)
>
> sources:
> http://smgl.positivism.org/bin/misc/man.cgi.txt
> http://smgl.positivism.org/bin/misc/wiki2man.pl
> http://smgl.positivism.org/bin/misc/wiki2man2.pl
>
> They are almost dirty hacks and table conversion support is a bit weak but
> sometimes works. I think I did something wrong on that part ;)
>
> On Fri, 5 Sep 2003, Dufflebunk wrote:
>
> > I wouldn't call yours stupid, yours cross references and stuff too IIRC,
> > very nice.
> >
> > I'm trying to figure out a way to pull out all (or most) the function
> > calls
> > a function makes, but I'm not having any luck. I imagine that would remove
> > the need for all the typing in your web based stuff?
> >
> > --------- Original Message --------
> > From: David Kowis <dkowis+smdiscuss AT shlrm.org>
> > > Heck yeah!
> > > That's lots better than the stoopid web application I made. You have to
> > > do
> > too
> > > much typing to make mine work.
> > > kudos for dufflebunk!
> > > Quoting &quot;Eric D. Schabell M.Sc&quot;
> > &lt;projectlead AT sourcemage.org&gt;:
> > >
> > > &gt; On Friday 05 September 2003 06:54, Dufflebunk wrote:
> > > &gt; &gt; Due to popular demand, I expanded the script. It can now
> > > handle
> > any
> > > &gt; &gt; number of source files, and will create function and script
> > indicies.
> > > &gt; &gt; Example output: http://dufflebunk.homeip.net/~dufflebunk/docs/
> > > &gt; &gt; Script at: http://dufflebunk.homeip.net/~dufflebunk/bashdoc.sh
> > > &gt; &gt;
> > > &gt;
> > > &gt; Nice, let's get this rolling with the Web Team to place it on
> > > &gt; docs.sourcemage.org asap (well, once the various sorcery stuff has
> > been run
> > > &gt; thru it of course!).
> > > &gt;
> > > &gt; Well done dufflebunk!
> > > &gt;
> > > &gt; --
> > > &gt; /*
> > > &gt; * Eric D. Schabell M.Sc.
> > > &gt; * Project Lead Source Mage GNU/Linux
> > > &gt; *
> > > &gt; * SourceMage: http://www.sourcemage.org
> > > &gt; * Shopping: http://www.cafeshops.com/sourcemage
> > > &gt; * irc.freenode.net (#sourcemage)
> > > &gt; * nick -&gt; erics
> > > &gt; */
> > > &gt;
> > >
> > >
> > > find ~your -name '*base* | xargs chown :us
> > >
> > > -------------------------------------------------
> > > This mail sent through IMP: http://horde.org/imp/
> > >
> > >
> > >
> > >
> > _______________________________________________
> > SM-Discuss mailing list
> > SM-Discuss AT lists.ibiblio.org
> > http://lists.ibiblio.org/mailman/listinfo/sm-discuss
> >
>
> - --
> Seth Alan Woolley <seth at tautology.org>, SPAM/UCE is unauthorized
> Key id 7BEACC7D = 2978 0BD1 BA48 B671 C1EB 93F7 EDF4 3CDF 7BEA CC7D
> Full Key at seth.tautology.org and pgp.mit.edu. info: www.gnupg.org
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.2.2 (FreeBSD)
>
> iD8DBQE/WOEb7fQ833vqzH0RAudhAJ93hl5gQk/MOH6SipXvWeNaOIw2GQCeLo9Y
> pYLerbsfGJd1u+4CRcQCe2Q=
> =VOeU
> -----END PGP SIGNATURE-----





Archive powered by MHonArc 2.6.24.

Top of Page