On 29 January 2014 18:12, Gary V. Vaughan <g...@vaughan.pe> wrote:
> 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 :-)

That's not much better than having that extra script to scan and
update the MANPATH. It's the kind of thing that could exist outside of
LuaRocks.

> 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 ?

Yes, especially if they're not portable.

-- Hisham

------------------------------------------------------------------------------
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