User talk:Xtian

From ArchWiki
Revision as of 23:16, 26 September 2013 by Xtian (talk | contribs) (formatting edit)
Jump to: navigation, search

Never say never!

Editing Fonts wiki page brings up style question

    "Also you may need to update your Xorg configuration files 
    (e.g. /etc/X11/xorg.conf or /etc/xorg.conf) with the new 
    directory. Search for FontPath to find the correct location 
    within the files to add your new path. See #Fonts with X.Org 
    for more detail." [1]

In this paragraph, the user is directed to edit their xorg.conf file with the actual font path. In this context of fonts and X11 the reader is brought to a context of a complex system of files and directories. Fonts may be placed in at least two locations by the information on this page. Xorg manages many other resources and loads conf directives from different files. In other words we're not talking about, say, a user's application with resource files just in the user's home director under a dot file.

Therefore, given this context, the action word "search" has an ambiguous meaning which could refer to searching for files or directories such as "fonts.dir" (an index file used by to find font files).

The meaning is easy enough to understand: upon opening the xorg.conf file do a text document search for "FontPath"; however, this is not common documentation reference. Here is an example from's Fonts documentation.

    "It is computed by appending all the directories mentioned 
    in the “FontPath” entries of the “Files” section in the order 
    in which they appear." [2]

While its useful to give quick advice to readers such as find the FontPath, and by the way the easiest way to do this is a text search--don't you know--its somewhat misleading. This is never more the case than when referencing some line about some app which needs to find some needle in the haystack. There's always one more thing, one more file, one more way to do something. Its bad enough that every Arch wiki page on an app like X11 must assume "your own installation may be different".

[1]: [2]: Xtian (talk) 23:15, 26 September 2013 (UTC)