[darcs-users] darcs patch: Remove literacy stub from Darcs.Flags. (and 44 more)

[Trent W. Buck]

Whew, these patches reduce the number of .lhs files that aren't really
.lhs files -- they just have a few \end{code}^J^J\begin{code}
sequences.

This is important for the technical writing team, because we can
ignore files that end in .hs.  If there are fewer .lhs files, it's
easier to find the files that actually *have* user documentation.

In Darcs 2.0.2, there were 122 .lhs files.  Now there are only 58.
That's nearly half that weren't really literate!

In a few cases I have promoted a literate comment to a Haddock
comment, because it was clearly API documentation.  The haddock markup
might need a little fine-tuning; in particular I have promoted a
couple of \section{silly} lines to first-level haddock markup, which
is probably really ugly.

PS: I actually did this work a fortnight ago, as a single patch, but
merging was so nightmarish that I re-did the work against unstable and
recorded patches per-file.

  * Remove literacy stub from Darcs.Flags.
  * Remove literacy stub from Darcs.IO.
  * Remove literacy stub from Darcs.Bug.
  * Remove literacy stub from Darcs.CheckFileSystem.
  * Remove literacy stub from Darcs.Global.
  * Remove literacy stub from Darcs.Hopefully.
  * Remove literacy stub from CommandLine.
  * Remove literacy stub from Darcs.Repository.Checkpoint.
  * Remove literacy stub from Darcs.Patch.MatchData.
  * Remove literacy stub from Darcs.SlurpDirectory.
  * Remove literacy stub from Darcs.Show.
  * Remove literacy stub from Darcs.Repository.InternalTypes.
  * Remove literacy stub from Darcs.Repository.ApplyPatches.
  * Remove literacy stub from Darcs.Patch.Set.
  * Remove literacy stub from Darcs.PrintPatch.
  * Remove literacy stub from Darcs.RemoteApply.
  * Remove literacy stub from Darcs.TouchesFiles.
  * Remove literacy stub from Darcs.TheCommands.
  * Remove literacy stub from Darcs.Sealed.
  * Remove literacy stub from Darcs.SignalHandler.
  * Remove literacy stub from Darcs.Patch.FileName.
  * Remove literacy stub from Darcs.Repository.Format.
  * Remove literacy stub from Darcs.Ordered.
  * Remove literacy stub from Darcs.Patch.Bundle.
  * Remove literacy stub from Darcs.Patch.Patchy.
  * Remove literacy stub from Darcs.Patch.Permutations.
  * Remove literacy stub from Darcs.Patch.QuickCheck.
  * Remove literacy stub from Darcs.Patch.Unit.
  * Remove literacy stub from Darcs.Patch.Viewing.
  * Remove literacy stub from Darcs.Repository.
  * Remove literacy stub from Darcs.Repository.Cache.
  * Remove literacy stub from Darcs.Repository.HashedIO.
  * Remove literacy stub from Darcs.Repository.Pristine.
  * Remove literacy stub from Darcs.SelectChanges.
  * Remove literacy stub from Darcs.Patch.Check.
  * Remove literacy stub from Darcs.Patch.Depends.
  * Remove literacy stub from Darcs.Patch.Non.
  * Remove literacy stub from Darcs.Patch.Real.
  * Remove literacy stub from Darcs.Repository.HashedRepo.
  * Remove literacy stub from Darcs.SlurpDirectory.Internal.
  * Remove literacy stub from Darcs.Patch.Test.
  * Remove literacy stub from Darcs.Patch.Read.
  * Remove literacy stub from Darcs.Patch.Info.
  * Remove literacy stub from Darcs.Patch.Choices.
  * Haddockize Darcs.Lock.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: text/x-darcs-patch
Size: 178390 bytes
Desc: A darcs patch for your repository!
Url : http://lists.osuosl.org/pipermail/darcs-users/attachments/20081109/8802bd6b/attachment-0001.bin