Date: Sat, 9 Jun 2007 09:36:51 -0700 From: David Southwell <david@vizion2000.net> To: ports@freebsd.org Subject: ./options-descr file suggestion for ports Message-ID: <200706090936.51775.david@vizion2000.net>
next in thread | raw e-mail | index | archive | help
Hi Would it be possible , when a port has options, to ask porters if they would consider the merits/demerits of adding: 1. An ./options-descr file in the port directory that describes the options, their purpose and any notes about an option Reasons: This would be extremely useful for anyone not familiar with the port to help in the task of choosing which options to install. I realise that this would depend upon whether maintainers are willing to add an additional task to the already heavy burden they undertake. Maintainers who are willing to consider this idea but are reluctant to prepare the notes themselves but do not have the time or are for any reason reluctant to do so, could invite users to submit notes for incorporating in ./options-descr. By way of example I am just installing www/ruby-gem-rails and had no immediate idea whether or not to add fastcgi support without trying to find out whether it is or is not needed when one has mod_ruby installed and LoadModule ruby_module libexec/apache/mod_ruby.so in httpd.conf. A brief note in a ./options-descr could be very helpful, especially for some ports where the options are sometimes numerous and not always completely documented. A little bit of intial guidance about options would be most helpful to a system administrator who is not necessarily familiar with the a specific port. my two pennorth. david
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200706090936.51775.david>