This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [docbook] How to mark up a path?


Jirka Kosek wrote:
> Tobias Reif wrote:
>
>> None of the following seems appropriate:
>>
>> <filename>doc/jing.html</filename>
>
> This seems perfectly reasonable for me.

Yes, but not to me :)
It doesn't make sense to argue about that if the goal is to reach consesus since our requirements seem to be different.


To elaborate on why I'm not really happy with the above
(again, it's cool if you're happy with it, but that's not the point):

file name:
  jing.html
... marked up as file name:
  <filename>jing.html</filename>

relative directory path:
  doc/
absolute directory path:
  /foo/
relative file paths:
  doc/jing.html  jing.html
absolute file path:
  /foo/doc/jing.html

("jing.html" can be a file name or a file path)

There is a difference between a file path and a file name which is significant in some cases, in which I'd like to express that difference via markup. (note: I don't say that this would be your requirement)

I think I might be happy with an element named path, but I'm not sure.

Tobi

--
http://www.pinkjuice.com/


--------------------------------------------------------------------- To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org For additional commands, e-mail: docbook-help@lists.oasis-open.org


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]