1. Chad Perrin
  2. shafd

Commits

Chad Perrin  committed 89593ed

linewraps

  • Participants
  • Parent commits 88ea48a
  • Branches default

Comments (0)

Files changed (1)

File README.md

View file
 # Specification for Hierarchical Auxiliary File Defaults
 
-This specification establishes a clear guide to the common practices of default paths used to store auxiliary files for applications in the POSIX/Unix developer culture.
+This specification establishes a clear guide to the common practices of default
+paths used to store auxiliary files for applications in the POSIX/Unix
+developer culture.
 
 ## Rationale
 
-POSIX/Unix applications often use configuration and data files that are particular to those applications.  In cases where an application depends on some other piece of software that defines its own defaults for file location, as in the case of applications that make use of DBMSes such as PostgreSQL and HTML servers like nginx, the application may offload the task of defining file location defaults to that other software.  Where the application developer must make his or her own decisions about where to place files by default within a given application's design philosophy, however, the option to push the problem off onto another application developer's choices is not available.
+POSIX/Unix applications often use configuration and data files that are
+particular to those applications.  In cases where an application depends on
+some other piece of software that defines its own defaults for file location,
+as in the case of applications that make use of DBMSes such as PostgreSQL and
+HTML servers like nginx, the application may offload the task of defining file
+location defaults to that other software.  Where the application developer must
+make his or her own decisions about where to place files by default within a
+given application's design philosophy, however, the option to push the problem
+off onto another application developer's choices is not available.
 
-The ad-hoc approach has given rise to a few different takes on "best practice".  Three appear most notable: the FHS, the XDG Base Directory Specification, and the emergent de facto standard approach of many of the rest of the POSIX/Unix development world.
+The ad-hoc approach has given rise to a few different takes on "best practice".
+Three appear most notable: the FHS, the XDG Base Directory Specification, and
+the emergent de facto standard approach of many of the rest of the POSIX/Unix
+development world.
 
 ### FHS
 
-The Filesystem Hierarchy Standard has emerged from the Linux community as an attempt to homogenize practices for developers of Unix-like OSes and the applications that run on them with regard to the organization of the virtual filesystem.
+The Filesystem Hierarchy Standard has emerged from the Linux community as an
+attempt to homogenize practices for developers of Unix-like OSes and the
+applications that run on them with regard to the organization of the virtual
+filesystem.
 
-While the FHS gives some guidance on where a developer may choose to place files related to his or her application, that guidance is largely incidental with regard to configuration and data files, and mostly silent with regard to user-specific configuration and data files.  It is for this reason a group of Linux developers chose to extend the FHS with the XDG Base Directory Specification.
+While the FHS gives some guidance on where a developer may choose to place
+files related to his or her application, that guidance is largely incidental
+with regard to configuration and data files, and mostly silent with regard to
+user-specific configuration and data files.  It is for this reason a group of
+Linux developers chose to extend the FHS with the XDG Base Directory
+Specification.
 
-The FHS suffers some problems of its own, apart from its (lack of) direct treatment of certain classes of application-specific files.  While some BSD Unix developers were involved in the development of the FHS, as a process of extending the older and more Linux-specific FSSTND (Filesystem Standard) to apply to Unix-like systems in general, Linux development culture indelibly marks the FHS with its departures from decades of common Unix practices and tendency to encourage clutter in directories traditionally reserved for limited use by the needs of the core system as well as arbitrarily deep subhierarchies that can make navigation via shell or file browser inconvenient.
+The FHS suffers some problems of its own, apart from its (lack of) direct
+treatment of certain classes of application-specific files.  While some BSD
+Unix developers were involved in the development of the FHS, as a process of
+extending the older and more Linux-specific FSSTND (Filesystem Standard) to
+apply to Unix-like systems in general, Linux development culture indelibly
+marks the FHS with its departures from decades of common Unix practices and
+tendency to encourage clutter in directories traditionally reserved for limited
+use by the needs of the core system as well as arbitrarily deep subhierarchies
+that can make navigation via shell or file browser inconvenient.
 
-The design of the FHS, in an attempt to compromise between the practices of a variety of different operating system projects, arrived at a standard that tends to encourage proliferation of symlinks and hardlinks in default installs.  This becomes necessary because the FHS conflicts in some way with almost every pre-existing operating system's virtual filesystem organizational principles.  To maintain backward compatibility with previous practices, OS developers choose to either create links within the filesystem to satisfy the FHS or move directories to comply and create links to provide backward compatibility, resulting in unreasonable clutter.
+The design of the FHS, in an attempt to compromise between the practices of a
+variety of different operating system projects, arrived at a standard that
+tends to encourage proliferation of symlinks and hardlinks in default installs.
+This becomes necessary because the FHS conflicts in some way with almost every
+pre-existing operating system's virtual filesystem organizational principles.
+To maintain backward compatibility with previous practices, OS developers
+choose to either create links within the filesystem to satisfy the FHS or move
+directories to comply and create links to provide backward compatibility,
+resulting in unreasonable clutter.
 
-While the goals of the FHS -- which involve making life easier for developers by establishing a standard on which developers can rely when writing cross-platform applications -- are noble, the execution has been one of political compromise that, to some degree at least, fails to consider the reasoning from experience that gave rise to many of the choices made in more traditional filesystem hierarchies.
+While the goals of the FHS -- which involve making life easier for developers
+by establishing a standard on which developers can rely when writing
+cross-platform applications -- are noble, the execution has been one of
+political compromise that, to some degree at least, fails to consider the
+reasoning from experience that gave rise to many of the choices made in more
+traditional filesystem hierarchies.
 
-As a result of these issues, drawing specifically and primarily from the FHS when choosing where to place application-specific files can tend to reinforce, proliferate, and perpetuate the mistakes of the FHS.  While conforming to the FHS as much as reasonably possible is a good idea for purposes of application portability, "reasonable" requires doing so without ignoring the benefits of conflicting filesystem hierarchy specifications.
+As a result of these issues, drawing specifically and primarily from the FHS
+when choosing where to place application-specific files can tend to reinforce,
+proliferate, and perpetuate the mistakes of the FHS.  While conforming to the
+FHS as much as reasonably possible is a good idea for purposes of application
+portability, "reasonable" requires doing so without ignoring the benefits of
+conflicting filesystem hierarchy specifications.
 
 ### XDG BDS
 
-Where the FHS deals with overall virtual filesystem design, it does not have much to say about the choices made by applications with regard to their own auxiliary file paths unrelated to the core system.  The XDG Base Directory Specification attempts to fill that gap.
+Where the FHS deals with overall virtual filesystem design, it does not have
+much to say about the choices made by applications with regard to their own
+auxiliary file paths unrelated to the core system.  The XDG Base Directory
+Specification attempts to fill that gap.
 
-A specification that explicitly establishes conformance to the FHS while providing a clear and portable set of guidelines for defining the default paths for the auxiliary files created and/or used by applications, including user-level file path guidance, is in and of itself an excellent idea.  Even better, the XDG BDS also does so in a way that provides for portable, standardized approaches to defining non-default paths on an individual basis.
+A specification that explicitly establishes conformance to the FHS while
+providing a clear and portable set of guidelines for defining the default paths
+for the auxiliary files created and/or used by applications, including
+user-level file path guidance, is in and of itself an excellent idea.  Even
+better, the XDG BDS also does so in a way that provides for portable,
+standardized approaches to defining non-default paths on an individual basis.
 
-The XDG BDS itself, however, suffers some problems.  For example, it does not take into account any filesystem hierarchy practices apart from the FHS in 
+The XDG BDS itself, however, suffers some problems.  For example, it does not
+take into account any filesystem hierarchy practices apart from the FHS in 
 
 
 ## Conclusion