FREQUENTLY ASKED QUESTIONS
==========================

Q Does Lima work on Windows ?

A Yes, if you use Windows Subsystem for Liux (WSL)
  See https://docs.limalib.dev/Installation.html.

Q Does Lima work with other drivers ?

A No - it was written specifically for FluffOS.
  It could be converted for other drivers (eg LDMUD or DGD),
  but that would involve a lot of work.

Q Does Lima work on OS X? (or other versions of *nix)

A It should do. However we don't test on all versions.
  Report any problems compiling the driver on Lima Bean 
 (limalib.dev:7878)

Q Why doesn't the mud work - says it can't find the mudlib directory ?

A This usually means faulty filepaths in config.lima in the /etc directory.
  Usual problems are either not getting the correct absolute filepath,
  or editing in a Windows/DOS editor, instead of *nix.

Q Why don't my code changes have any effect ?

A Firstly "update" the changed file, to make sure it compiles without error.
  Generally objects already in the mud will still use the "old" code, 
  and only newly created objects will use the "new" code.
  Using the "renew" command on an old object should replace the "old" code
  with the "new" code.
  You may also need to use "update -R" on objects which inherit the code 
  that you have changed.
  If all else fails, try rebooting the mud. However, make sure that 
  you've not "broken" any critical files (eg anything inherited by the 
  user or body), which would stop the mud from booting, or stop you from
  logging in.

Q I've broken the mud, and it won't boot. WHat do I do ?

A Restore the mud from the last backup.
  Restore the broken file from its last backup.

Q How do I make backups ?

A The entire mud can be backed up by using the "backup" script in the /etc
  directory.
  Individual files can be backed up with the "bak" command, which places a
  copy in the corresponding BAK directory, name amended to incorporate a
  timestamp. Restore with the "rst" command.

Q Where is the Lima documentaion?

A Start with   https://docs.limalib.dev/
  The help files - either "help <subject>" or browse through the
  /help/ directory
  Read the code
  Look at examples in the /domains/std/ directory

Q How can I learn LPC?

A https://docs.limalib.dev/ - see the learning path tutorials.
  They are split into sveral parts with exercises.

Q how do I call functions from the command line / shell prompt?

A Use the "@" command - eg "@.me->query_health()"
  Details are available in the shell help ("?" from the shell prompt)

Q Why don't add_actions work in Lima?

A They have deliberately been disabled, as they are far inferior to verbs,
  and should not be used.
  See the design_decisions section in help for full reasons.

Q How do I use verbs ?

A Read "help verbs" and "help parser" for details.
  Don't forget the undocumented command "rehash" to get the parser to 
  recognise a new verb when you've written it.

Q How do I get my new verb to work properly ?

A Best way to find what is wrong is to use the "parse" command in front of 
  the verb - eg "parse smash apple" to see why "smash apple" isn't working.

Q How do I find/fix errors in my code ?

A Start with the "dbxwhere <playername>" and "dbxframe <playername> <frame>" 
  commands to see where the error is occuring.
  You may then need to show yourself variable values at that point - 
  see the LBUG etc macros in /include/global.h, add one for yourself, 
  add in a suitable statement to your code (eg "LBUG(myvar);") 
  then update the code and try again.
  If you can't fix it yourself, try asking on Lima Bean, but fixing other
  people's problems takes much longer than fixing our own, and we often
  don't have the time available to do anything other than suggest places
  you can look for yourself.

Q I've found a bug. What do I do ?

A Report it on LIMA or in github.

Q How do I give money to myself (or another player) ?

A Use "@.me->add_money(type, number)" - eg @.me->give_money("copper",3)
  See /std/body/money.c for details.

Q I changed one of the default colours, but it had no effect. Why ?

A Your colour settings will have been set to the old default colours.
  To change to a new one, clear the old one.
  In the "colours" command, use the "colours remove <whatever>" syntax.
  Any newly created characters will automatically start with the current
  default colour settings.

Q Why is the suicide command disabled ?

A Because it doesn't work properly in its current form.
  The security system prevents a player command accessing secure data,
  so the deletion fails.
  If you want to enable it, look at how the "finger" command uses redirection
  to a command in the /trans/cmds/ directory, and daemons in the /secure/
  directory to achieve access to secure player data.

Q How do players customise the prompt to show hit points etc ?

A They don't.
  Lima's health system was written to reduce processor load by only 
  calculating halth (hit points) when required.
  If you calculate that every time a command is entered, you've wiped
  out most of that gain.
  The system is also modular, with options for using limb- or wound-
  based health,  which would probably be too detailed to display in a prompt.
  It may be useful to add a display each round during combat, in which case
  look at /std/adversary/main.c for the main combat loop.
