March 2001 Archives

Title Bout: Jim v. Doctools

| | Comments (5)
Well, here I am. I have a site to collect my thought. I have my new Handspring to do PalmOS programming with. I have the beginnings of a PalmOS Developer's Document. I want to make it into a full fledged HOWTO written in the LDP or Doctools style. I'm going to continually update this story to track my progress and questions. I've been tearing my hair out on this one. Any tips would be appreciated.[Update Thu Mar 29 13:28:29 AKST 2001] I got it working! Read on for details.

I'm starting with the docbook install mini-howto from http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/

I'm going with openjade instead of jade. Seems to do the same things. I'm installing everything in /usr/local/sgml (even though this should do XML as well). Here's what I'm installing

  • openjade 1.3 http://openjade.sourceforge.net/
  • DocBook SGML DTD (v3.1 and v4.1 ) http://www.oasis-open.org/docbook/sgml/index.html
  • ISO8879 ENTITY SGML
    • http://www.oasis-open.org/cover/topics.html#entities
    • http://www.oasis-open.org/cover/ISOEnts.zip
    • http://www.oasis-open.org/cover/isoENT-tar.gz
  • DocBook DSSSL. I'm getting both the norman walsh base and the ldp additions.
    • http://nwalsh.com/docbook/dsssl/
    • http://www.linuxdoc.org/authors/tools/ldp.dsl
  • I'm not installing Sgmltools-lite, htmldoc, or docbook2X. I don't think I need them yet.

Now to the install

First openjade. It seems to be a well behaved GNU autotools app. I got it with ./configure --prefix=/usr/local/sgml/openjad-1.3 && make && make install

Now I'm ready to install the docbook DTD's. No compiling just unpacking

styx:~# cd /usr/local/sgml/
styx:/usr/local/sgml# 
styx:/usr/local/sgml# mkdir docbook
styx:/usr/local/sgml# cd docbook
styx:/usr/local/sgml/docbook# mkdir 3.1 4.1 
styx:/usr/local/sgml/docbook# cd 3.1
styx:/usr/local/sgml/docbook/3.1# unzip -a /usr/local/sgml/0archive/docbk
styx:/usr/local/sgml/docbook/3.1# cd ../4.1/
styx:/usr/local/sgml/docbook/4.1# unzip -a /usr/local/sgml/0archive/docbk41.zip 

Next, unpack the ISO8879 Entities

styx:/usr/local/sgml/docbook/4.1# unzip -a /usr/local/sgml/0archive/ISOEnts.zip 
styx:/usr/local/sgml/docbook/4.1# cd ../3.1/
styx:/usr/local/sgml/docbook/3.1# unzip -a /usr/local/sgml/0archive/ISOEnts.zip 
Note that the files from ISOent-tar.gz end in.ent, but need to end in .gml. Here is a one line bash script to move them all to the right name.

styx:/usr/local/sgml/docbook/3.1# cd /tmp
styx:/tmp# mkdir ents
styx:/tmp# cd ents
styx:/tmp/ents# tar -xzf /usr/local/sgml/0archive/isoENT-tar.gz 
styx:/tmp/ents# for i in `find . -type f`;do mv $i `echo $i | sed -e 's/.ent/.gml/g'`;done

Now that they are all renamed, I'll get them into the 3.1 and 4.1 directories respectively. I see that there is a bit of filesystem redundancy with my install method. But I want to be overly cautious right now because I've learned from previous attempts that I know nothing about how this really works yet :)
styx:/tmp/ents# cd /usr/local/sgml/docbook/3.1
styx:/usr/local/sgml/docbook/3.1# cp /tmp/ents/* .
styx:/usr/local/sgml/docbook/3.1# cd ../3.1/
styx:/usr/local/sgml/docbook/3.1# cd ../4.1/
styx:/usr/local/sgml/docbook/4.1# cp /tmp/ents/* .
Now the howto says to make symlinks from the .cat file to a catalog file.
styx:/usr/local/sgml/docbook/4.1# ln -s docbook.cat catalog
styx:/usr/local/sgml/docbook/4.1# cd ../3.1/
styx:/usr/local/sgml/docbook/3.1# ln -s docbook.cat  catalog
Now, moving on to the DSSSL. Again, just unzipping with no compilation required.
styx:~# cd /usr/local/sgml/
styx:/usr/local/sgml# mkdir dsssl
styx:/usr/local/sgml# cd dsssl
styx:/usr/local/sgml/dsssl# unzip -a /usr/local/sgml/0archive/db164.zip
styx:/usr/local/sgml/dsssl# cd docbook/
styx:/usr/local/sgml/dsssl/docbook# cp /usr/local/sgml/0archive/ldp.dsl html/
styx:/usr/local/sgml/dsssl/docbook# cp /usr/local/sgml/0archive/ldp.dsl print
Movin' right along... This is the bugger. You have to setup and SGML_CATALOG_FILES shell variable. Since I don't know which catalog files I'll actually use to produce one of these thingies, I'm not sure whether I need to use all of them. This is where I'm starting. I saved the following in a file called ldp_environ.sh.

JADE_HOME=/usr/local/sgml/openjade-1.3
SGML_SHARE=/usr/local/sgml

PATH=$PATH:$JADE_HOME/bin

# DSSSL stylesheets
#       Norm Walsh's Modular DocBook Stylesheets
SGML_CATALOG_FILES=$SGML_SHARE/dsssl/docbook/catalog
#       OpenJade stylesheets
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$JADE_HOME/dsssl/catalog
#       sgmltools-lite's stylesheets
#SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/stylesheets/sgmltools/sgmltools.cat

# DocBook DTD
#       From OASIS-Open.org
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/3.1/catalog
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/4.1/catalog
#       These old ones were installed with doctools-1.2 from XFree86.org
#SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/2.4.1/catalog
#SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/3.0/catalog

# sgmltools-lite catalogs for LinuxDoc
#SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/dtd/sgmltools/catalog

export JADE_HOME SGML_SHARE PATH SGML_CATALOG_FILES
##########################################################################################

Now I can do something like this...

styx:/usr/local/sgml# . /etc/profile
styx:/usr/local/sgml# echo $PATH
/bin:/usr/bin:/usr/local/openjade-1.3/bin
styx:/usr/local/sgml# echo $SGML_CATALOG_FILES 
/usr/local/sgml/dsssl/docbook/catalog:/usr/local/sgml/openjade-1.3/dsssl/catalog:/usr/local/sgml/docbook/3.1/catalog:/usr/local/sgml/docbook/4.1/catalog

The HOWTO Says I'm done now, minus of course the components I chose not to install.

There is a sample document located on the howto page (http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/using.html). I'll try to use it as input first.

The first time I ran jade I was missing libraries. Easily fixed. I added openjade-1.3 to my ld.so.conf file and ran ldconfig. It's odd that openldap doesn't create a lib directory it just sticks it all in the PREFIX directory.

Doh! This is the place I always get stuck. I'm really glad I'm recording all this, because I hope somebody will be able to help.

styx:/usr/local/sgml# openjade -t sgml -d $SGML_SHARE/dsssl/docbook/html/docbook.dsl test.sgml

openjade:/usr/local/sgml/docbook/3.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/dbcent.mod:145:0:E: cannot open "/usr/local/sgml/docbook/3.1/iso-grk4.gml" (No such file or directory)
openjade:/usr/local/sgml/docbook/3.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/3.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:1:73:W: cannot generate system identifier for public text "-//James Clark//DTD DSSSL Style Sheet//EN"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:309:0:E: reference to entity "STYLE-SHEET" for which no system identifier could be generated
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:1:0: entity was defined here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:309:0:E: DTD did not contain element declaration for document type name
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:66:0:E: notation "DSSSL" for entity "dbl1el" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:75:0:E: notation "DSSSL" for entity "dbl1en" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:84:0:E: notation "DSSSL" for entity "dbl1es" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:93:0:E: notation "DSSSL" for entity "dbl1et" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:102:0:E: notation "DSSSL" for entity "dbl1fi" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:255:0:E: notation "DSSSL" for entity "dbl1zhcn" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:111:0:E: notation "DSSSL" for entity "dbl1fr" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:165:0:E: notation "DSSSL" for entity "dbl1nl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:174:0:E: notation "DSSSL" for entity "dbl1no" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:201:0:E: notation "DSSSL" for entity "dbl1ptbr" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:267:0:E: notation "DSSSL" for entity "dblib.dsl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:183:0:E: notation "DSSSL" for entity "dbl1pl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:120:0:E: notation "DSSSL" for entity "dbl1hu" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:192:0:E: notation "DSSSL" for entity "dbl1pt" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:129:0:E: notation "DSSSL" for entity "dbl1id" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:138:0:E: notation "DSSSL" for entity "dbl1it" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:270:0:E: notation "DSSSL" for entity "dbparam.dsl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:147:0:E: notation "DSSSL" for entity "dbl1ja" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:210:0:E: notation "DSSSL" for entity "dbl1ro" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:30:0:E: notation "DSSSL" for entity "dbl1ca" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:219:0:E: notation "DSSSL" for entity "dbl1ru" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:39:0:E: notation "DSSSL" for entity "dbl1cs" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:156:0:E: notation "DSSSL" for entity "dbl1ko" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:228:0:E: notation "DSSSL" for entity "dbl1sk" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:237:0:E: notation "DSSSL" for entity "dbl1sl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:48:0:E: notation "DSSSL" for entity "dbl1da" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:246:0:E: notation "DSSSL" for entity "dbl1sv" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:57:0:E: notation "DSSSL" for entity "dbl1de" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:311:12:E: element "STYLE-SHEET" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:312:24:E: there is no attribute "ID"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:313:8:E: there is no attribute "USE"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:313:105:E: element "STYLE-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:315:25:E: element "STYLE-SPECIFICATION-BODY" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:27:E: there is no attribute "ID"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:46:E: there is no attribute "DOCUMENT"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:59:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:441:55:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:443:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:444:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:445:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:446:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:447:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:448:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:449:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:450:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:451:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:452:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:453:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:454:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:455:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:456:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:457:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:458:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:459:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:460:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:461:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:462:53:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:463:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:464:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:465:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:466:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:467:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:468:53:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:468:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:467:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:466:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:465:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:464:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:463:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:462:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:461:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:460:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:459:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:458:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:457:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:456:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:455:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:454:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:453:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:452:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:451:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:450:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:449:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:448:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:447:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:446:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:445:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:444:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:443:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:441:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:0: start tag was here
openjade:E: specification document does not have the DSSSL architecture as a base architecture
This is a TestJohnDoeLj.doe@jdoe dot comv1.02000-12-30jldThis is a test DocBook document.Test 1Test section 1.Test 1.1Test section 1.1Test 1.2-- Test section 1.2 
openjade -t sgml -d $DSLFILE test.sgmlTest 2Test section 2.Test 2.1Test section 2.1
	Test 2.2Test section 2.2



[Update Thu Mar 29 10:44:20 AKST 2001]

I sent an email off to the doctools@linuxdoc.org mailing list and have (promptly) gotten some suggestions. I need to reduce my SGML_CATALOG_FILES variable to only the catalogs I am using for this compile: DSSSL, Docbook4.1, and openjade's catalog files. Here is my SGML_CATALOG_FILES variable now.

styx:/usr/local/sgml# echo $SGML_CATALOG_FILES
/usr/local/sgml/dsssl/docbook/catalog:/usr/local/sgml/openjade-1.3/dsssl/catalog:/usr/local/sgml/docbook/4.1/catalog
Whoa! of noteworthy interest, I have no catalog files in openjade. Greg suggests looking for a usr/local/sgml/openjade-1.3/dsssl/catalog file. I don't have that. I'll press and post to the list in a minute. So here I go with another attempt at compiling test.sgml. Using the command from Greg....
styx:/usr/local/sgml# openjade -t sgml -i html -d $SGML_SHARE/dsssl/docbook/html/docbook.dsl test.sgml
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/dbcent.mod:145:0:E: cannot open "/usr/local/sgml/docbook/4.1/iso-grk4.gml" (No such file or directory)
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:1:73:W: cannot generate system identifier for public text "-//James Clark//DTD DSSSL Style Sheet//EN"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:309:0:E: reference to entity "STYLE-SHEET" for which no system identifier could be generated
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:1:0: entity was defined here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:309:0:E: DTD did not contain element declaration for document type name
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:66:0:E: notation "DSSSL" for entity "dbl1el" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:75:0:E: notation "DSSSL" for entity "dbl1en" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:84:0:E: notation "DSSSL" for entity "dbl1es" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:93:0:E: notation "DSSSL" for entity "dbl1et" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:102:0:E: notation "DSSSL" for entity "dbl1fi" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:255:0:E: notation "DSSSL" for entity "dbl1zhcn" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:111:0:E: notation "DSSSL" for entity "dbl1fr" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:165:0:E: notation "DSSSL" for entity "dbl1nl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:174:0:E: notation "DSSSL" for entity "dbl1no" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:201:0:E: notation "DSSSL" for entity "dbl1ptbr" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:267:0:E: notation "DSSSL" for entity "dblib.dsl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:183:0:E: notation "DSSSL" for entity "dbl1pl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:120:0:E: notation "DSSSL" for entity "dbl1hu" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:192:0:E: notation "DSSSL" for entity "dbl1pt" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:129:0:E: notation "DSSSL" for entity "dbl1id" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:138:0:E: notation "DSSSL" for entity "dbl1it" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:270:0:E: notation "DSSSL" for entity "dbparam.dsl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:147:0:E: notation "DSSSL" for entity "dbl1ja" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:210:0:E: notation "DSSSL" for entity "dbl1ro" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:30:0:E: notation "DSSSL" for entity "dbl1ca" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:219:0:E: notation "DSSSL" for entity "dbl1ru" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:39:0:E: notation "DSSSL" for entity "dbl1cs" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:156:0:E: notation "DSSSL" for entity "dbl1ko" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:228:0:E: notation "DSSSL" for entity "dbl1sk" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:237:0:E: notation "DSSSL" for entity "dbl1sl" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:48:0:E: notation "DSSSL" for entity "dbl1da" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:246:0:E: notation "DSSSL" for entity "dbl1sv" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:57:0:E: notation "DSSSL" for entity "dbl1de" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:311:12:E: element "STYLE-SHEET" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:312:24:E: there is no attribute "ID"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:313:8:E: there is no attribute "USE"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:313:105:E: element "STYLE-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:315:25:E: element "STYLE-SPECIFICATION-BODY" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:27:E: there is no attribute "ID"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:46:E: there is no attribute "DOCUMENT"
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:59:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:441:55:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:443:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:444:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:445:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:446:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:447:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:448:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:449:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:450:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:451:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:452:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:453:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:454:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:455:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:456:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:457:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:458:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:459:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:460:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:461:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:462:53:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:463:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:464:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:465:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:466:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:467:49:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:468:53:E: element "EXTERNAL-SPECIFICATION" undefined
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:468:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:467:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:466:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:465:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:464:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:463:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:462:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:461:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:460:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:459:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:458:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:457:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:456:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:455:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:454:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:453:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:452:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:451:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:450:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:449:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:448:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:447:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:446:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:445:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:444:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:443:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:441:0: start tag was here
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:470:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but its declaration does not permit this
openjade:/usr/local/sgml/dsssl/docbook/html/docbook.dsl:440:0: start tag was here
openjade:E: specification document does not have the DSSSL architecture as a base architecture
This is a TestJohnDoeLj.doe@jdoe dot comv1.02000-12-30jldThis is a test DocBook document.Test 1Test section 1.Test 1.1Test section 1.1Test 1.2-- Test section 1.2 
openjade -t sgml -d $DSLFILE test.sgmlTest 2Test section 2.Test 2.1Test section 2.1
	Test 2.2Test section 2.2

Plot thickens. I noticed there was a dsssl subdirectory in the openjade source tree. Just for giggles I copied it into /usr/local/sgml/openjade-1.3. This is where my $SGML_CATALOG_FILES expects to find it.

Wooohoooo! It Worked

I was just able to compile the 3.1 version of the HOWTO-howto. A big round of Thanks to Greg Fergusson and Dan Scott for there suggestions :)

Visor Edge: Enter Stage Right

|
Well, with the untimely demise of my PalmIIIe, I had to order another device to make up for all the brain cells that PalmOS has replaced. I definitely wanted a Handspring because of spring board modules. I bought the new Visor Edge. I had a real saga with my first edge. I had a tiff with Handspring over a faulty device and some rude support professionals. But a fine gentlemen named Paul at Handspring customer support had it cleared up and a new one shipped immediately. Regardless of all that crap, I love my new Visor Edge. If I could ever get doctools to work, I would get to hackin' some palm code for the howto I'm working on. You should read the eloquent drivel between Handspring and I. They really did turn out to be a great company. [Update Tue, 03 Apr 2001 08:33:47 GMT] My Second Visor Edge broke [Update Mon Apr 23 11:09:03 AKDT 2001] My Third Visor Edge [Update Tue Apr 24 16:00:04 AKDT 2001] I don't use Handsprings anymore.

My original Email From: Jim Weller jim.weller@gci.net Received: 03/22/2001 03:22am Eastern Standard Time To: technicalsupport support@cl2.handspring.com Subject: Other Inquiry FROM: Jim Weller EMAIL: jim.weller@gci.net PHONE: (907) 786-4656 ZIP CODE: 99508 INQUIRY_TYPE: Other Inquiry CRADLE_TYPE: USB INSTALLED_OS: Win2000 PIM #: palm desktop INSTALLED_SOFTWARE: Yes Installed PRODUCT: Visor Edge COMMENTS: To Whom it may concern, I'm in a dismal position and I feel like I was just put aside by your organization. I hope that you review this as a professional memo from one Customer Support Representative (CSR) to another and not as a peevish consumer complaint. Here is my story. I read about the slick new Visor Edge on www.slashdot.org. I was intrigued by the design so I went and watched the webcast video on your web site. I then ordered one directly from handspring.com. Elated at its arrival of my first Handspring device, I opened my new Edge and went through the sacred ritual of retiring my old PalmIIIe with one final hotsync. I was quite pleased with my new purchase. See, I use PalmOS all day. I'm a busy tech manager and student at the University of Alaska. I'm also a small business owner. I'm also an avid PalmOS hobbyist and linux hacker. I wrote the linux palm developer's howto located at http://www.linuxdoc.org/LDP/palmdevqs/index.html I used my Edge all day tues and wed. I was so pleased to have this slick new device during our UAA technology forum ( 30+ new contacts and 52 new todo items). Then, about 7:30pm 2001.03.21 AKST my new Handspring Visor Edge stopped working. The taps on screen *always* brought up the command menus on the top of the screen! No matter where I tapped. Well needless to say I was concerned. I wanted to do a cold reset, but I hadn't hotsynced all this *IMPORTANT* data from the Technology Expo. I rushed to my office where my USB cradle lay and hotsynced using the cradle button. I had to use the hotsync button because I couldn't tap the hotsync icon to sync over IR like I normally do. Luckily, the hotsync worked and I have all my new contacts and todos 'safely' tucked away on my PC. After I backed up the data to the PC, like a good little PalmOS user, I did a cold reset on my palm. I'm of course prompted to tap anywhere to continue initialization. The first step of which is to run the digitizer. The intuitive reader, should have already figured out that the screen input was damaged. For the non-intuitive, the screen input was damaged. When I tapped the first target the second appeared as expected. But when I tapped the second target, rather than displaying a target in center-screen the first target reappeared. Meaning that the coordinates of my taps are not registering correctly. It's probably just a loose connection, but I don't want to open it and void my warranty. It goes without saying, that I'm in a bad situation and need a replacement device; exchanged or bought. I called 1 (888) 565-9393 because on the this website: http://www.handspring.com/support/repairs.jhtml I read the following (cut and pasted from that site). -------- If you purchased your product directly from Handspring you may return it for full credit within 30 days from shipment as long as it is in good condition. To arrange for a return, please call Handspring's CustomerCare Center at 1 (888) 565-9393 seven days a week, 24 hours a day. Please be sure to have your credit card available when you call. Custom cases may not be returned except in the case of manufacturer's defect or order fulfillment error. ------------ The part I really like is "to arrange for a return." Because when I called this number I was to told to call technical support at (716)-871-6448. I don't really need technical support as I'm confident of the problem. But I didn't want to make trouble. So, I called for the benefit of your order tracking system. They were, of course, closed as I'm on Alaska time. Do you really want to setup your customers for that fall? Do your CSR's not know your tech support hours? Why couldn't they just transfer me to tech support directly? After lolligagging around your support lines, I finally reached a charming women at the first phone number (2nd call). I asked if she could simply start the appropriate procedure for me to return a defective Visor Edge ( I'll get to that ). She said "No" as trained. I then asked if there was someone who could. She said "No" as trained. At this point, I'm irate. I *rely* on this tool all day, every day. It is a staple of my career, education, and business. She said, in a most offensive and condescending tone, something to the effect of (paraphrased) "I should already know about the tech support procedures." I got mad and expressed my distaste at the situation. Then, without explanation or salutation, your representative hung up the phone on me. You'll probably have it recorded, I implore you to go visit that recording ( 9:00pm 2001.03.21 AKST ). You have got to be kidding me right? I spent $412 on my *FIRST* Handspring device. It's faulty. And customer support hangs up on me? Are you comprehending the impression that I've been left with? Maybe I misunderstood your interpretation of "arrange for a return." So there is my story. You have my credit card reciept, my registration, and hopefully a recorded phone call to your customer support. You've read my troubleshooting procedures and I should hope that they meet or exceed those of your tech support hotline. As a tech professional and computer science student, I should think that this information is sufficient to generate an RMA number. I'm in the technical support business. I work as the lead on a callcenter team for the University of Alaska, Anchorage and have been for 5+ years. I handle anywhere from 40 to 100+ support calls a day. I understand your rep's sentiments about her lack of capacity to help me. I can even empathize with her frustration at my insistence. I even understand having to dismiss a support call because of a rude, beligerent, or intolerable customer. But I'm still incredulous at her unprofessional manner during and ending that support call. It's not the money I can afford another dozen PalmOS devices. It's no longer about your product. My 2.5 day stint with my Edge proved that I do like Visors. Now, it is about your company. Now it's about voting with my money. I'm making this a very clear ultimatum. ******************************************************************************************* If I do not get a *PHONE CALL* tommorow at my work number (907)-786- 4656 with a valid solution to my problem, I will NEVER BUY NOR RECOMMEND HANDSPRING, ITS SERVICES, OR ITS PRODUCTS. ******************************************************************************************* I don't mean to sound threatening. I actually want to help. I don't enjoy harassing corporation's tech support staff. As a matter of fact, this is an utter waste of my time. I'm losing money and I'm short a PalmOS device! Besides, I'm just one customer among hundreds of thousands (millions?). I don't have anything to threaten your with. But know that I am going to be rolling out armies of PalmOS handhelds. Either indirectly through my linux palmos developer's howto or directly through the mobile sales system I'm implementing for a local Wine Distributor. Never mind my future PalmOS plans for my company. Note, that I don't mention these things for clout. Like I said I'm a drop in the bucket compared to all your collective customers. I mention them so you see I have a vested interest in PalmOS devices. I mention them, because I want your people to think about and discuss what I have said here. Ultimately, I have to go get a PalmOS device at the store tommorow. I'll go the day without one to give you a chance to discuss and respond. Even if our relationship as vendor and customer comes to an end, as one customer support professional to others, I truly hope that this story will end in a lively and active discussion about support; what it means and how to organize it. It is also my ardent hope you will consider modifying your support infrastructure to include a customer friendly single point of contact. Even if it isn't realistic to merge your tech and customer support personnel, you could at bare minimum put them all in a voice menu behind ONE PHONE NUMBER. Is it really a customer's responsibility to track phone numbers within your organization? Do you want to make your customers extra work to get to you? You might think of your personnel units as filling distinct roles in the organization, but to us customers you're all Handspring :) Thank you for your time and consideration. A potentially loyal and lucrative customer, Jim Weller E: jim.weller@gci.net W: (907) 786-4656 H: (907) 562-1965 ------ Please do not remove your unique tracking number! ------ <<#156058-264271#>>


Handspring Support's Automated Response From: support@cl2.handspring.com support@cl2.handspring.com To: jim.weller@gci.net Subject: RE: Other Inquiry Date: Thu, 22 Mar 2001 08:21:30 GMT Thank you for contacting Handspring! We received your email and will do our very best to respond within 24 hours. Handspring Technical Support www.handspring.com
Handspring's First Human Response From: PuneeSet support@cl2.handspring.com To: jim.weller@gci.net Subject: Re: Other Inquiry <<#156058-264271#>> Date: Thu, 22 Mar 2001 17:55:29 GMT Dear Jim Weller, Thank you for your Email. We are sorry for all the inconvenience. At this point, you can call our Customer Service Toll free number at 1-888-565-9393 or call the Technical Support line at 1-716-871-6448 for a replacement. We are open from 8am to 10pm EST, Monday to Friday and 10am to 7pm on Saturday and Sunday. Please provide the unique tracking number to the Customer Service. We hope that you will be a happy customer again once you get your replacement for the Visor Edge. If you still have any questions please Email us back or call the Technical Support line at 1-716-871-6448. We are open from 8am to 10pm EST, Monday to Friday and 10am to 7pm on Saturday and Sunday. Thank you, Handspring Technical Support
Handspring's Second Human Response To: jim.weller@gci.net From: LakshRam support@cl2.handspring.com Subject: Re: Urgent Exchange, Questions and Suggestions <<#156058-264308#>> Date: Thu, 22 Mar 2001 19:23:32 GMT Dear Jim Weller, Thank you for contacting Handspring. We apologize for the inconvenience caused to you in this regard. One of our product specialists will be contacting you at the number provided by you. If you need any further assistance, please contact our Technical support line at 716 871 6448 or email us back at support@cl2.handspring.com. We are open from 8am to 10pm EST, Monday to Friday and 10am to 7pm on Saturday and Sunday. Thank you, Handspring Technical Support
After, all that and a phone conversation with the afore mentioned Paul, my new Handspring arrived on the March 23, 2001. I was so pleased with Handspring's performance I even recommended them to one of my clients. Here's the exchange with the client's privacy protected.
Client's Initial Query From: [...] To: "'Jim Weller'" jim.weller@gci.net Subject: RE: InfoTech Goals Date: Mon, 2 Apr 2001 12:30:20 -0800 Hello Jim, I am considering the purchase of either a Palm Pilot or a Handspring Visor. Which do you recommend? The Visor uses AA batteries. Is that a significant limitation? Is 8mb enough to download excel files? I like the expandability of the Visor but I wonder how necessary that really is for me. The Visor appears to be more expensive. Regards, [...]
My recommendation for Handspring From: "Jim Weller" jim.weller@gci.net To: [...] Subject: Re: InfoTech Goals Date: Mon, 2 Apr 2001 14:11:14 -0800 [...], It's interesting that you should mention this, b/c I was talking with Rob, Miah, and Mike and thinking about a mobile sales force type application for SI's long term to help reduce human error in processing inventory changes/requests. There are some nice spreadsheet apps (tinysheet) out there, but the real question is the size of the data that you intend to store. 8 megs is usually totally sufficient. I even keep two 50+ page PDFs on mine for reference. Assuming you don't just cram the thing with data, you'll definitely be able to convert spreadsheets to tinysheet and be able to have quite a few of them in your Palm device. I do recommend the Visors. They are more expensive, but the spring board modules are nice if you do outgrow your 8megs. I went for visor's spring board for less 'formal' reasons. I wanted to attach an mp3 player. Plus, I've had exceptional service and support from the Handspring company when I needed it badly. I don't really like the direction 3com/Palm is heading with there add on modules. One set of AAA batteries lasted more than a month with my PalmIIIe. My new Visor Edge is rechargeable and I've yet to reach it's power threshold. Color devices will obviously use more power. All the PalmOS devices do have secondary internal batteries. So, when you run out of main juice, you can't turn the device on, but the secondary battery keeps your data intact. Even through a battery switch. Never mind the fact that this is all synchronized and archived on your PC or Mac :) It has been one of my more useful geek toy investments. Be warned: You'll love it. It will allow you to automate and amass a huge amount of details that were cluttering your brain and stressing your human animal. At first it feels like pavlovian conditioning, but you'll be able to shape it to the way you live very quickly. It really sets your focus to goals instead of myriads of details. The pay off of a shallow learning curve is worth the benefit of reminders, scheduling, and fast access to information. Murphy's Rule for Conservation of Free Time: Work will fill all time space that time saving devices free up :) When/If you get one, let me know I have all kinds of helpful tips and programs. Jim
My client's reply From: [...] To: "'Jim Weller'" jim.weller@gci.net Subject: RE: InfoTech Goals Date: Mon, 2 Apr 2001 14:21:18 -0800 Jim, Thanks for the advice. It looks like Visor is the direction I am headed. [...]
Now this is where it get's really lame. My second visor had the exact same defect. Is it bad luck or bad manufacturing? Only the third will tell. Most people probably wouldn't even try that many times. Below is my exchange with Handspring. I talked with Omesh on the phone. If he is the example, then Handspring support is all right in my book.
My second feedback to handspring. From: "Jim Weller" jim.weller@gci.net To: support@handspring.com Subject: Case#1284175: Losing My Faith. Date: Mon, 2 Apr 2001 18:48:40 -0800 Dear Paul and Handspring, (archived @ http://www.jimweller.net/article.php?sid=15&mode=&order=0) I hope my case is not the norm, as it is causing me some distress. I'm on my second defective visor edge, and am quite leary of my third. I'm writing this email in hopes that it provides a reasonable history of my experience with handspring. I hope that Paul can give my case the same rush treatment that he did last time as my described circumstances still rely on my Handspring device by the minute. I've gone *way* out of my way to help you. I hope you're doing the same for me. Below is my story. You can read it in chronological order on my website. I had some initial trouble with support, but thanks to the efforts of some great support professionals (Paul and Omesh) I've quite gotten over my initial concerns about the company. Now, I'm reversing my tact. I'm concerned about the Visor Edge product specifically. I have friends, clients, and colleagues with 3com Palms and other models of Visors. I'm the only one with a Visor Edge :) I've been a handheld user for years now and am quite familiar with their care and feeding ( impact, moisture, temperature etc.). I pamper mine. It has it's own little padded case where it is warm, dry, and safe from harm. My peers with other handspring and palm products have not had the bout of bad luck that I'm currently having with my Edge(s). Despite the fact that they are quite a bit more abusive to their devices. I can't think that I've done anything to damage either of the Edges I've had since none of my described symtoms are corellary in time to a drop or impact or ugly incident with water or heat. But after a *very* short use (about a week), I've had, not one, but two Visor Edge's succumb to the same defect with the screen input that is mentioned in my trouble description below. When you consider that I've only been a Handspring customer since March 16, 20001 ( 2 weeks) and I've already been through two identically defective products, even for such a small sampling of data, that is a horrible track record for the product itself. Has anybody taken the time to see if there are similar problems with other Edge customers? I'd be quite interested to know! If a supervisor of either Paul or Omesh reads this email, pat those two on the back and give them a raise to keep them on board. They have what it takes to be support pros in the fast paced tech world. If Paul or Omesh reads this email, have your Supervisor call me. I'd like to talk to one about your outstanding performance. I had my faith restored for about 6 days. I even recommended the Visor Edge to a customer of mine (see attached email). I have to say though, that if this third Edge doesn't work out, I'll be sorely disappointed. I'm not sure what I'll do then. I'll definetely want my money back, but I'm not sure what my next PalmOS product will be. Verbosely Yours, Jim Weller E: jim.weller@gci.net W: (907) 786-4656 H: (907) 562-1965
[Update Tue, 03 Apr 2001 08:33:47 GMT] From: MatthLal support@cl2.handspring.com To: jim.weller@gci.net Subject: Re: Case#1284175: Losing My Faith. <<#156058-264271#>> Date: Tue, 03 Apr 2001 08:33:47 GMT Dear Jim Weller, Thank you for your email I have re-escalated your case to Paul I am sure he will get in touch with you as soon as possible. If you have troubleshooting issues or general questions related to Handspring products, contact Handspring Technical Support at (716) 871-6448 from 8:00 AM to 10:00 PM Monday to Friday and 10:00 AM to 7:00 PM Weekends Eastern Standard Time. Thank you, Handspring Technical Support
Working with my 3rd Edge [Update Sat Apr 7 02:21:15 AKDT 2001] I have my new Edge and am happily chugging away. There still just the sharpest little PDAs. I hope this one works out for me. Thanks to handspring. Note to Hanspring: One of the problems with the stylus on the side is that it makes it hard to keep a good grip on the device as you remove the stylus. To remove the stylus while holding the device in the PalmTop style, you have to either: 1. Remove your fingers from the stylus area. This makes it such that you no longer have a firm grasp on the device as you apply force to remove the stylus. This means you have one solid hold point (your thumb). Bad. 2. Relax your fingers on the stylus to reduce the friction. This way the stylus can slide past your fingers. But now you are only loosely holding the palm device. Basically, you have to sacrifice a firm grip on the Visor Edge in order to remove the stylus. I think this was a space saving, but risky design decision.
[Update Mon Apr 23 11:09:03 AKDT 2001] IT BROKE AGAIN! This is absolutely unbelievable. I'm incredulous and outraged. Same frickin' problem. I have another dead hanspring. I haven't had it even two weeks and the third one is kaput with the exact same error. No matter where I touch on screen it always brings up the menu bar. This time I had the added benefit of a 'Fatal Exception' after about 3 screen clicks. Now, beauty, the power switch won't even turn the damn thing on. Needless to say I'm hot. This is my 3rd junker Edge in a month. This is just to much of an inconvenience. I didn't pay $412 to do QA for Handspring! And they have batted 0 for 3 at this point. I think that the edge is either a bunk design or something went way below specs in the fabrication.
Me talking to Hanspring (again) about this faulty edge From: "Jim Weller" jim.weller@gci.net To: support@handspring.com Subject: 3rd Dead Visor Edge in one Month Date: Monday, April 23, 2001 11:40 AM To Whom it may concern, You should read the history located at: http://www.jimweller.net/article.php?sid=15 You should read and understand it before talking to me. I'm not going through anymore technical support or customer service hoops. I wouldn't mind talking to Paul as we at least seem to have a rapport. I'm really upset and, statistically speaking, cannot trust another Visor Edge. I just expect someone to call me soon and have a really good offer for me. Customer by the thread at the end of the rope, Jim Weller E: jim.weller@gci.net W: (907) 786-4656 H: (907) 562-1965
Everybody is having problems [Update Tue Apr 24 13:21:12 AKDT 2001] I started looking on the internet and in forums for other users having problems. Boy are they! The visor edge has only been out for about 2 months and already the reports are pouring in about digitizer problems and battery woes. Other folks are having my problem. Check this out at Visor central http://discussion.visorcentral.com/vcforum/showthread.php?s=192d47f4f168d71bc1a928b2b38ae7c3&threadid=13486 http://discussion.visorcentral.com/vcforum/showthread.php?s=192d47f4f168d71bc1a928b2b38ae7c3&threadid=13638 http://discussion.visorcentral.com/vcforum/showthread.php?s=192d47f4f168d71bc1a928b2b38ae7c3&threadid=13424 This off of Google Groups http://groups.google.com/groups?hl=en&lr=&safe=off&ic=1&th=eedb23f4eb76ad9b&seekd=913006802#913006802
An optimistic Dave calls from Handspring A nice CSR named Dave called me about 1:30PM AKST. I told him that I was leary of another edge and would like to upgrade to a prism. My colleagues have had success with this and sibling form factor models. I've wasted hours of my expensive time with them, and I'm giving them another shot. It seemed the least they could do to keep me as a customer. Dave was optimistic about the proposition and hung up to discuss it with a supervisor.
Handspring disses me, and offers to give me my money back. First off they didn't even call me. But I guess I'd be ashamed to break the bad news to. Imagine how pissed that person you were calling to give the below bad news to would be. Especially, when you consider that the difference between the Edge and the Prism is $37! From: Dcagle@Handspring.com To: jim.weller@gci.net Subject: Handspring case #2013260 Date: Tue, 24 Apr 2001 15:30:01 -0700 Mr. Weller, I have checked with our Customer Service department concerning a replacement/upgrade of your Edge for a Prism, and unfortunately this is something we would not be able to do. I can however authorize a complete refund on the Edge you purchased from Handspring. To be able to issue a RMA for the return of the Edge and it's refund, I need the following information: The serial number of the Edge. Additionally, can you please verify the following information is correct?: James Weller XXXXXXXXXX xxxxxxxx@xxxxxxxxxxxxxx UAA ITS 3211 Providence Dr XXX Bldg Room# XXX Anchorage, AK 99508 I would like to apologize for the experience you have had with Handspring. Dave Cagle Technical Support - Level 3 Handspring
Jim Weller officially swears off Handspring This is my last correspondence with Handspring. From: "Jim Weller" jim.weller@gci.net To: Dcagle@Handspring.com Subject: Re: Handspring case #2013260 Date: Tue, 24 Apr 2001 16:01:11 -0800 Mr. Cagle, I'm well tempted to flame you in a discourse on Handspring, but I feel I've given HS plenty of free hours of un-noticed feedback and I don't think it would help you help me. I'm bereaved that Handspring has terminated our relationship as vendor and customer. I had high hopes. This has ultimately left me with a sour disappointment at how I chose to spend my $412 dollars as well as a regret for the recommendations I made to my employees and clients for your products. I wasted much of my time and their money. I hope that someone pensively reviews these email and phone conversations. I'll continue to archive them at http://www.jimweller.net/article.php?sid=15. The contact information that you list below has changed since I have been relocated for renovation. The new information is listed below. James Weller XXXXXXXXX xxxxxxx@xxxxxxx.xxx UAA ITS 3211 Providence Dr XXX Bldg Room# XXX Anchorage, AK 99508 The Serial Number of the defective Visor Edge is #BGFED112300B4 Thank you for your apology. Thank Paul and Omesh for their outstanding service. A disappointed non-Handspring customer, Jim Weller
Final Gory Details From: Dcagle@Handspring.com To: jim.weller@gci.net Subject: RE: Handspring case #2013260 Date: Tue, 24 Apr 2001 17:09:17 -0700 Thank you for the praise for Paul and Omesh. It will be forwarded to them. Your RMA number is HS-E0-00446-010424-01 It should be arriving within 3 business days. Please package up the Edge with all the materials that came with it and return it to Handspring using the materials provided. Once received, a full refund will be issued to you. Again, I do apologize for the experience you have had with Handspring and hope that you will reconsider being a Handspring user in the future. Dave Cagle Tech Support - level 3 Handspring
Well 15 days (10 business days) later. I haven't gotten my RMA package. Here's the gripe email.
From: "Jim Weller" To: Dcagle@Handspring.com Subject: RE: Handspring case #2013260 Date: Thu, 10 May 2001 11:57:15 -0800 Mr. Cagle, Regarding RMA#HS-E0-00446-010424-01, I haven't recieve the shipment you mentioned in your email. It has been 10 business days. --- Jim
Jerked around and misinformed. Where do they get off? It'll be interesting to see how long it takes to get a refund. I
From: Dcagle@Handspring.com To: jim.weller@gci.net Subject: RE: Handspring case #2013260 Date: Thu, 10 May 2001 14:20:30 -0700 Mr. Weller, Sorry for the delay and the confusion on my part. I believed that out shipping department would be sending you a box in which to return the Edge, but that only happens if we are replacing the Edge, not refunding on it. Please ship the Edge and all the items that came with it to the following address: 11201 Electron Dr. Louisville, KY 40299 Attn: Jessica Schlicher Please include the RMA number in the box. When shipping it back, please use our Fed-X account number. It is 2563-0317-5. When asked for a phone number of the person Fed-X should contact should they have any questions, please give them my number (650-230-5000 x5285) I am sorry for the mix up. Dave Cagle Technical Support Specialist Handspring dcagle@handspring.com
Harumph. Here's where I tell them that they accidentally shipped me an extra device. I'm certain it would fail to (look at the failure rate so far). So, I want nothing to do with it.
From: "Jim Weller" To: Subject: Re: Handspring case #2013260 Date: Fri, 11 May 2001 10:57:58 -0800 Mr. Cagle, I should also note that an extra replacement Visor Edge was sent to me. I'm not sure how that mixup occured. I've had a total of 4 devices. I'm returning it as well. Jim Weller

PalmIIIe: Exit Stage Front

|
It was a good day. I'd convinced all the techie troglodytes in our office to wear ties and dress sharp. I followed suit and wore a nice shirt with a breast pocket. Naturally, wanting to niche into the geek image, I placed my palm in my breast pocket. That was the fatal stroke for my Palm IIIe. When bending over in the bathroom to pull up my trousers my little IIIe leaped from my breast to its death on the bathroom floor. It's screen cracked and never saw another grafitti stroke or button press. Not a very flashy story, but what followed was interesting.

My co-worker's Palm III had a similar fate. His Palm's mainboard bit the dust during a smoking break accident. Well, You can do the math. My screen was cracked, and his board was smashed. Nothing left to do, but try and make the pieces fit. And they did! We are now the proud owners of a Palm IIIe with a Palm III screen plate. Notice that the quick tap buttons don't match the palm model :)

James' Lan Party

|
James Conner (http://www.jamesconner.net) threw a roxxor 31337 LAN party this last weekend (All Quake). He sacrificed his NT box (get a real OS) to the LAN gods, and should be about done reinstalling his box. Quake is such a fickle game with it's obfuscated network code. Anyway here are some shots.

Hiking on the Arm

|
Ben, Rob and I went and recklessesly paraded around the arm this memorial day sunday. Of course no matter where we go...We've gotta be Wine Whores.

Broken Arm

|
Doh! I broke my hand falling off of my new bicycle. Hurts like hell and hacka-hacka is seriously hampered. The worst part is showering with a plastic bag on. Picture of plaster gauntlet below.

[Update]

They finally took off the plaster gauntlet and replaced it with a slightly shieker version.
At least my fingers are kind of free to type and Quake.


[Update]

The fiber gauntlet has finally left the building. After 3 botched attempts at getting Dr.'s appointments I finally
removed the damn cast myself (with a leatherman :). Don't give me any crap, I was three days past due and I did it right.
I sawed half way through the shell of the cast and then broke out pieces along the sawed groove. Then I bathed it...Ahhhhh.

Kansas: Weller, Weller & Glisson

|
Rob, Caroline and I are visiting our loving relatives in Kansas. This involves a lot of food. I've probably gained 15 lbs since I've been here. We went to this lovely place about 30mi outside of KC. It had 825(!) acres of tended gardens. We've been having a wonderful time with family and old friends.

Winewhores is Gold

|
After a year of hard work my wine tasting groups web site is done. Wine Whores
are a force to be reckoned with. No really. I worked hard on this page and associated computer
system. I love it a lot and I hope you do to :)

Palm Developer's Quick Start Guide

|
I'm teaching myself to program the palm. And, well, you know me I wrote down how I did it and I'm posting it on the web. Maybe it will help someone. I sure as heck could have used it. It's like 3:30 in the morning now and I'm going to bed. But you should check out The Palm Developer's Quick Start Guide.

[Update] I got published on the linux documentation project. Woohoo!

But it's still rock n' roll to me

|
My new site is up. The look is about the same, but I'm using a nice content engine called PHP Website. It's a slick product; if a bit undocumented. No watch me go...

I intend to use this site to harvest ideas from my own dusty brain. I'm also hopeful that this new content manager will allow me to skip most of the pretense of HTML so that I might focus on some of my articles.

You know me! It'll be sloppy and jargonny, but Ultra 1337 :)