tag not doing The Right Thing

[Rich Bowen <rb...@rcbowen.com>]

The <directive> tag appears to be behaving inconsistently. The anchor
tag is sometimes working, sometimes not. I'm not completely sure what
the conditions are for making each happen, but it seems that sometimes
the anchor is being left in the case it was used, and other times it is
lowercasing it.

For example:

<directive module="core">Directory</directive>

is producing a link to core.html#Directory which is not a valid anchor.

It seems that other times it was lowercasing the anchor, but I am now
unable to find any examples of that, and Mozilla is segfaulting, making
the search difficult.

I'm not clear on what the Right Thing To Do is in this situation, but I
thought I'd mention it.

-- 
Nothing is perfekt. Certainly not me.
Success to failure. Just a matter of degrees.


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

RE: tag not doing The Right Thing

[Joshua Slive <jo...@slive.ca>]

> From: Rich Bowen [mailto:rbowen@rcbowen.com]

> On Sun, 17 Feb 2002, Joshua Slive wrote:
>
> > 2. Use all lower case.  Fewer links will be broken, but I would need to
> > scatter translate(.,$uppercase,$lowercase) all over the xsl file.
>
> I was under the impression that all the anchors were lowercase, and so
> this would make sense to me. However, if there are mixed-case links,
> this would mean the tedious job of searching and fixing.

OK.  I went with all lowercase fragments (although I also left a mixed case
anchor in there for now).

I also fixed the stylesheet so now <directive
type="section">Directory</directive> should do the "right thing".

I also took a look at the stuff you checked in last night.  They look
excellent to me.  The only thing I changed was to use <directive> in a
couple places that you didn't.  Even if we don't need to link, it is best to
mark <directive>s as such, because I think it might be good to present them
in a different color/font.

Thanks for your help!

Joshua.


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

Re: tag not doing The Right Thing

[Rich Bowen <rb...@rcbowen.com>]

On Sun, 17 Feb 2002, Joshua Slive wrote:

> 2. Use all lower case.  Fewer links will be broken, but I would need to
> scatter translate(.,$uppercase,$lowercase) all over the xsl file.

I was under the impression that all the anchors were lowercase, and so
this would make sense to me. However, if there are mixed-case links,
this would mean the tedious job of searching and fixing.

> 3. Use mixed-case as the canonical form, but also include an all-lowercase
> anchor to support unconverted docs.  This means that a few inter-module
> links would be broken, but only until we finished converting the module
> docs.  And as soon as I get core done, that will cover the most important
> stuff.
>
> I favor number 3, but I'm open to anything else.

Well, this is certainly the least work for the most number of people,
meaning that you would have to do it and not me. ;-) So, yeah, this
option seems fine from my perspective!

-- 
Rich Bowen - rbowen@rcbowen.com
ReefKnot - http://www.reefknot.org


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

Re: tag not doing The Right Thing

[Joshua Slive <jo...@slive.ca>]

On Sun, 17 Feb 2002, Rich Bowen wrote:
> For example:
>
> <directive module="core">Directory</directive>
>
> is producing a link to core.html#Directory which is not a valid anchor.

I assume you mean because the true anchor is "directory" in all lower
case.

Well, this is a little kettle of fish.  As far as I can tell, "fragments"
(or anchors, or whatever) are supposed to be case sensitive, although I
can't find it explicitly mentioned in a spec.  MSIE treats them
as case-insensitive, but Mozilla treats them as case-sensitive.  I tend
to trust Mozilla in this case.

This creates a little problem.  Case of anchors is handled very
inconsistently in the docs at the moment.  The majority are probably lower
case, but there are a large number of mixed case.  There is no way to
match that and do automatic linking.

Options:

1. Use the same case as the <name> (ie, mixed case).  This will mean that
many links in the docs will be broken until everything is converted to
xml, but they will still get you to an index that points to the right
place.

2. Use all lower case.  Fewer links will be broken, but I would need to
scatter translate(.,$uppercase,$lowercase) all over the xsl file.

3. Use mixed-case as the canonical form, but also include an all-lowercase
anchor to support unconverted docs.  This means that a few inter-module
links would be broken, but only until we finished converting the module
docs.  And as soon as I get core done, that will cover the most important
stuff.

I favor number 3, but I'm open to anything else.

Joshua.


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org