[darcs-users] [issue1413] remove duplicate documentation

Trent W. Buck trentbuck at gmail.com
Mon Apr 6 07:05:45 UTC 2009


trentbuck at gmail.com (Trent W. Buck) writes:

> I've deleted the identical parts of Commute.  However I can see that
> there's also duplication between Core and Prim.  Which should I keep?

I answered this for myself.  

>>> I believe the manual build process is using Prim and ignoring
>>> Commute, or maybe just ignoring the duplicated section.

I don't think so.  As you can see, currently four of the seven literate
documents in Darcs.Patch are included in the user manual:

    $ grep -r '\\input.*Darcs/Patch' src
    src/Darcs/Arguments.lhs:\input{Darcs/Patch/Match.lhs}
    src/Darcs/Patch.lhs:\input{Darcs/Patch/Apply.lhs}
    src/Darcs/Patch.lhs:\input{Darcs/Patch/Core.lhs}
    src/Darcs/Patch.lhs:\input{Darcs/Patch/Commute.lhs}
    src/Darcs/Patch.lhs:\input{Darcs/Patch/Show.lhs}
    src/darcs.tex:\input{Darcs/Patch.lhs}

The ones that aren't are Match, Prim and Properties.  The last of those
is currently built as a separate document, patch_theory.pdf, which
everyone hates.

So for now I will attempt to rearrange literate documentation within
Darcs.Patch such that it ends up in an appendix of the user manual.
I will start by removing duplicated text from Prim rather than from
Commute and Core.



More information about the darcs-users mailing list