[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Axiom-developer] RE: Ping: case insensitive filesystems

From: Page, Bill
Subject: [Axiom-developer] RE: Ping: case insensitive filesystems
Date: Wed, 15 Nov 2006 12:14:57 -0500

On Wednesday, November 15, 2006 10:48 AM Gaby wrote:
> Bill Page writes:
> [...]
> | My suggestiong is that when we start to work on a patch, we first
> | ask on the axiom-developer list for someone to play the role of
> | 2nd person. Perhaps this is a way for people who do not yet feel
> | bold enough to work on Axiom themselves yet to get started.
> That would definitely increase the among of shared knowledge.
> | Yes, I would agree to act as the 2nd person and write such
> | documentation from time to time. :-)
> OK, you're officially appointed as that second person :-)

Here is my proposed documentation patch to src/hyper/Makefile:

$ diff -au Makefile.pamphlet_orig Makefile.pamphlet

--- Makefile.pamphlet_orig      2006-11-12 22:20:19.000000000 -0600
+++ Makefile.pamphlet   2006-11-15 11:11:09.000000000 -0600
@@ -145,6 +145,11 @@

+There are two files for each (special) character glyph, one
+for the upper case form, and one for the lower case form.
+For more information about hese bitmaps see '' in the
+section 'pages', below.
 mouse11.bitmap: $(srcdir)/bitmaps.pamphlet
        $(axiom_build_document) --tangle=mouse11.bitmap --output=$@ $<
@@ -236,6 +241,17 @@

+The 'ht.db' is built when pages from 'src/hyper/pages' such as
+and 'util.pht' are installed in the target directory. Because the .db
+file must be kept in sync with the page filesof course care must be
+taken not to overwrite these files at a later time without re-building
+the database.
+The Axiom system from which this branch had been made appears
+to contain a redundant copy of Removing the version of
+'' in 'src/share/doc/hypertex/pages/' would make
+Makefile logic simpler has been removed so as to minimize problems
+when this file is updated.

 The [[.pht]] files contain hardcoded pathnames to viewport directories
 in the installed system.  Of course, that is asking for trouble.
@@ -259,8 +275,19 @@
              ${HTADD} *.ht *.pht

-To avoid conflicts on case-insensitive filesytems we renamed
-to [[]] and [[poly.pht]] to [[polys.pht]].
+On case-insensitive filesytems such as Windows and traditional Mac
+checkout from the source archive can fail if files have names
+differing only in case: contra and
+poly.pht contra POLY.pht. To avoid conflicts on case-insensitive
+filesytems we renamed [[]] to [[]] and [[poly.pht]]
+to [[polys.pht]].
+The page [[]] refers to two files for each (special) character
+glyph, one for the upper case form, and one for the lower case form.
+The names for these files avoid the use of upper and lower letters
+to distinguish these forms. Intstead we use 'xxx.bitmap' for lower case
+and 'xxx-cap.bitmap' for upper case, where "xxx" is the common name for
+the glyth. For example alpha.bitmap and alpha-cap.bitmape.

 We need to make sure that [[ht.db]], the hypertex database file
 is up to date. The file contains absolute offsets into the various


Bill Page.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]