MathGroup Archive 2011

[Date Index] [Thread Index] [Author Index]

Search the Archive

Re: How to change the directory for the docs?

  • To: mathgroup at
  • Subject: [mg115299] Re: How to change the directory for the docs?
  • From: kj < at>
  • Date: Fri, 7 Jan 2011 04:07:48 -0500 (EST)
  • References: <ifmru5$pha$> <ifpk99$bso$> <ifs321$oq0$> <ifuorh$cbi$>

In <ifuorh$cbi$1 at> telefunkenvf14 <rgorka at> writes:

>On Jan 3, 2:57 am, kj <no.em... at> wrote:
>> In <ifpk99$bs... at> David Bailey <d... at> writes:
>> >It might help to explain why you want to do this. There is probably an
>> >easier way to achieve whatever it is you want to do.
>> Well, if you want to know, I've copied all the Mathematica
>> documentation notebooks to a personal directory, so that I can
>> modify them at will.  The ultimate goal is to supplement these
>> notebooks with important information that they lack, and to fix
>> factual errors in them.  I want all the built-in Mathematica help
>> facilities to point to these annotated notebooks rather than to
>> the "official" ones.
>> ~kj

>Now I'm intrigued... Can we make a wiki version?!?

That's exactly right.  In fact, I think that something similar to
a wiki should be the standard way to document all software.  The
difference from a wiki is that the various strands of contribution
(including the original documentation) are kept separate.  The
viewer can choose to turn on or off strands by individual authors.
I've seen something similar to this done before (Postgres, Perl),
but it has not caught on for some reason, despite the general
proliferation of wikis.

>(Guessing WRI would
>not be happy with this---umm...copy rights?)

That was my guess too.  Judging by the tight-fistedness of their
documentation, I can guess that they'd want absolute control over
anything that could be construed as documentation for Mathematica.
Avoiding hassles from WRI's lawyers is the main reason I have not
set up a wiki-like site like the one described above.  (And I
wouldn't be surprised on bit if WRI has squashed similar efforts


  • Prev by Date: Re: check if a square matrix is diagonal
  • Next by Date: Re: Using Extract where some indices are out of bounds (efficiently)
  • Previous by thread: Re: How to change the directory for the docs?
  • Next by thread: Re: How to change the directory for the docs?