OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: any semantic diff between a file name and directory name?

Robert P. J. Day [mailto:rpjday@crashcourse.ca] wrote:

>    i'm perusing the semantic markup of someone who has created their
> own XML language which, in all, looks fairly similar to docbook, but
> this person has explicitly defined two elements -- "file-name" and
> "directory-name" -- to be used for that respective markup.
>    i'm aware that docbook has the standard "filename" element and, as
> a longtime unix/linux user, i'm well aware that directories are simply
> special cases of files and i have always marked up directory names
> with just <filename>.

From a technical perspective a directory name and a file name might be the same, but the average computer user would likely scratch his/her head at that notion. So I could imagine a situation in which an author might want to treat the two items differently in order to communicate better with the average user.

I personally don't see the need for such a distinction in the types of documentation that I write, but I don't think it's that strange. So as usual, "it depends".  :-)

Rob Cavicchio
Principal Technical Writer & Information Architect
EMC Captiva
Information Intelligence Group
EMC Corporation
3721 Valley Centre Drive, Ste 200
San Diego, CA 92130

P: (858) 320-1208
F: (858) 320-1010
E: rob.cavicchio@emc.com

The opinions expressed here are my personal opinions. Content published here is not read or approved in advance by EMC and does not necessarily reflect the views and opinions of EMC.

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]