Hi Hisham,

> On Jan 30, 2014, at 5:19 AM, Hisham <h...@hisham.hm> wrote:
> 
>> On 26 January 2014 23:38, Gary V. Vaughan <g...@vaughan.pe> wrote:
>> Hi Hisham,
>> 
>> For rocks that provide scripts in bin, luarocks copies those out to 
>> $TREE_ROOT/bin, but there's currently no way to add Unix man pages.  Rather 
>> than special-casing certain directories, such as 'man' in the installed rock 
>> package trees (although that would be a useful feature in itself for more 
>> than just manual page hierarchies) I think it would be super-useful to have 
>> `luarocks path` set the MANPATH environment to include any install luarocks 
>> with top-level `man` directories.
>> 
>> As long as the installed rocks have `man` in install.copy_directories, and 
>> run "eval `luarocks path`" anyway, this puts manual pages where the `man` 
>> command can find them for free.
>> 
>> Thoughts?
> 
> The problem is that entries under bin/, share/lua/5.x/ and lib/lua/5.x
> are deployed to common directories, so that a single entry for them
> can be added to the appropriate path variables. Other files in the
> rock are not deployed like that, they are stored separately per-rock
> under lib/luarocks/rocks-5.x/<rock_name>/ so you have tens (or
> hundreds) of doc (or man) directories. So, it's not feasible to add
> them all to MANPATH one by one

Why not? Only the rocks that ship man pages in a 'man' directory will need to 
be added, and even a few dozen extra paths on MANPATH is better that not being 
able to read man pages - except by writing a script to search rocks trees 
manually and add those same paths to MANPATH by yourself.

> (and the result of eval `luarocks path`
> would be out of date as soon as you installed another rock, anyway).

Until you run luarocks path again :-)

Of course, I'd be even happier if luarocks amalgamated the man directories in 
the same way as the bin directories, but IIRC you were reluctant to start a 
trend of managing more and more special cases like that ?

Cheers,
-- 
Gary V. Vaughan (gary AT vaughan DOT pe)
------------------------------------------------------------------------------
WatchGuard Dimension instantly turns raw network data into actionable 
security intelligence. It gives you real-time visual feedback on key
security issues and trends.  Skip the complicated setup - simply import
a virtual appliance and go from zero to informed in seconds.
http://pubads.g.doubleclick.net/gampad/clk?id=123612991&iu=/4140/ostg.clktrk
_______________________________________________
Luarocks-developers mailing list
Luarocks-developers@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/luarocks-developers

Reply via email to