Back to TF Net

From: Jim DeHaven <Jim_DeHaven@spider
To: Rusty Tucker
Subject: documentation
Date:Sun, January 10, 1999 08:52 PM


I used to think I was smart until I tried to understand your documentation and parsing of SPML

I have not yet been able to consistently do things like define variables--certain variables from the register command do not echo (I asked this question months ago--but the best way to deal with a question is to ignore it and it goes away), and I have no clue how to specify a directory in the dir list command.

In additioon the use of quotes and case sensitivity seems inconsistent and variable from example to example.

Finally, when I read the apache stuff, there seems to be little syntactical consistency with SPML

In your documentation, rather than giving the absolutely simplest and most trivial example, why not show a real example, one that refers to a real directory. And put your examples in a context--an example that just has one line with little or no reference to the problem it is addressing is almost useless.

\When you say things like a variable lives for the life of a request--What is a request? how long does it live? How can anyone understand that kind of writing

If you claim that your language is consistent with Apache and yet Apach has commands and syntax that are undocumented in your version then either:

1) if there is a difference sy so
2) if there is no difference but you have just not documented it , the **say that**

My full time job is not trying to figure out what your docs say--you like to refer people to page and chapter of your docs but they are not very good aside from assisting one in using the moist very basic commands and included features.

I have spent 2 hours trying varioius methods to get TF to list the contents of a directory of my choosing rahter than the "requested directory" and I can think of thirty or more permutations of URL's and or directory delimeters that I could use--but to what end/ And there are questions like "does the dir list" command recognize directories that are in the web server's directory definition list. Who knows?

Lokk at this sentence

"If the path is empty ("") the requested directory is indexed."

What in the world does this mean? If I specified no directory by including the empty string in the dir= variable, then who or what "requested" the directory. I assume what you mean is the that the directory where the spml page I am using is located. Then why not say that? Do computer people simply sasy things in the most obscure way possible just to annoy customers and use up our time?

I have recently spent 3 months trying to get a portable computer (PC) to work on our network. A few weeks ago our MIS person informed me that portables work in one campus building and not the other due to certain protocol adjustments she has not yet made in the hardware in our building. Portables worked in the building where she was setting them up (because she needed the changes to do her job). So she was all set, so the whole world must be all set, because we can all read her mind. See the analogy?


99


Running TeleFinder Server v5.7.
© Copyright Spider Island Software