[kde-doc-english]Doc for konqueror

[Éric Bischoff]

On Wednesday 04 September 2002 13:41, Pam R wrote:
>
> "&L;" which expands to "<mousebutton>left</mousebutton> would be
> preferable, but still not ideal unless meinproc automatically capitalizes
> the first letter if it is the first word in a sentence ;-)
>
> But that raises another question in my mind, which is why do we need the
> <mousebutton> tag at all? As far as I can see it doesn't affect the final
> HTML.

It could. That possibility is enough.

> <rant>
> I believe that we have far too many markup tags, many of which seem to be
> in practice equivalent; <keysym> vs. <keycap> for example.

They aren't.

> meinproc --check
> will happily accept either <keysym>Enter</keysym> or <keycap>Enter</keycap>
> so there is no feedback to the author saying whether what he has entered is
> the correct choice (which should it be?). So why not have just one tag
> here?

Because they are not equivalent.

We could easily run a script to distinguish them. Furthermore, once they 
become rendered differently, we'll realize the error soon.

> There was some discussion a few months ago about the use of the <action>
> tag in the Command Reference section of a handbook. As I understand it no
> one could come up with a reason for using this tag.
>
> I also have to say that what really confuses me as a part-time author is
> the different markup that seems to be applied to different parts of a
> filename / path, for no apparent good reason.

Don't trust the apparences ;-).

-- 
Éric Bischoff