Page 1 of 1

Have the program tell the user what directories there are

Posted: Sun Mar 25, 2012 11:42 am
by SandJ
A common query is "Where do I install OXPs?"

Since the program itself knows where the files it uses are, how about adding a screen to the core Oolite program that is accessed from the options screen that gives directory information. For example:
example Ubuntu version wrote:
The first-timer's handbook is in:
[size=120]/usr/share/doc/oolite-data/AdviceForNewCommanders.pdf[/size]


OXPs should be installed in:
/home/SandJ/.Oolite/AddOns
e.g.
[size=120]/home/SandJ/.Oolite/AddOns/Basic-debug.oxp[/size]
[size=120]/home/SandJ/.Oolite/AddOns/ExampleOXP.oxp[/size]

Screen dumps are saved in:
[size=120]/home/SandJ/oolite-saves/snapshots[/size]

If asked to provide "Latest.log" it is in:
[size=120]/home/SandJ/.Oolite//Logs/Latest.log[/quote][/size]
example Windows version wrote:
The first-timer's handbook is in:
[size=120]D:\Games\Oolite\AdviceForNewCommanders.pdf[/size]


OXPs should be installed in:
D:\Games\Oolite\AddOns
e.g.
[size=120]D:\Games\Oolite\AddOns\Basic-debug.oxp[/size]
[size=120]D:\Games\Oolite\AddOns\ExampleOXP.oxp[/size]

Screen dumps are saved in:
[size=120]D:\Games\Oolite\oolite.app\oolite-saves\snapshots[/size]

If asked to provide "Latest.log" it is in:
[size=120]D:\Games\Oolite\oolite.app\Logs\Latest.log[/quote][/size]
In this way if multiple installations have been done, or there was an earlier broken installation, or it is a non-standard installation, it won't matter.

(It has taken me ages to put together this posting, which demonstrates just how hard it is to find this stuff. I did not know there was a .PDF for Linux, that the snapshot directory isn't created until you have a snapshot and the Windows installation gets Basic-debug.oxp but the Linux one doesn't. And none of the above refers to [size=120]/usr/lib/GNUstep/Applications/oolite.app[/size] which is where the program was installed! Nor that there is Linux manual for Oolite: "[size=120]man oolite[/size]", which I only just found by accident. Oh, I see the resource sheet is installed too, in [size=120]/usr/share/doc/oolite-data/OoliteRS.pdf[/size] . Razzle, frazzle, I knew none of this two hours ago!)

Re: Have the program tell the user what directories there ar

Posted: Sun Mar 25, 2012 12:23 pm
by Lone_Wolf
While this might be possible, keep in mind that there are many variations possible.

for example, on my archlinux install the docs are in /usr/share/doc/oolite , not /usr/share/doc/oolite-data .
( those things are/can be distro specific).

I expect a Wiki page would be easier to maintain and also have room for exceptions.

Re: Have the program tell the user what directories there ar

Posted: Sun Mar 25, 2012 2:34 pm
by Eric Walch
SandJ wrote:
A common query is "Where do I install OXPs?"

Since the program itself knows where the files it uses are, how about adding a screen to the core Oolite program that is accessed from the options screen that gives directory information.
They could buy a Mac :)

There the option is present for a long time. Select the oxp entry or the screenshot entry and that folder will be opened.

Image

Re: Have the program tell the user what directories there ar

Posted: Sun Mar 25, 2012 3:41 pm
by SandJ
Lone_Wolf wrote:
While this might be possible, keep in mind that there are many variations possible.
I don't mean the default locations. I mean the actual locations, like the D:\Games\Oolite\ example above. That's why the program should say where these directories are - it knows. It has to know to work.

Re: Have the program tell the user what directories there ar

Posted: Sun Mar 25, 2012 9:00 pm
by Greyth
It would be good to have an OXP management system...

Such that a loader program for Oolite can
...Check release numbers and update accordingly if connected to the internet
...Automatically display a list of OXP's available for install
...Download and install OXP's
...Enable or disable OXP's

That would take the sting out of the learning curve but I fear it would also dis-encourage exploration of how it all works?

Re: Have the program tell the user what directories there ar

Posted: Sun Mar 25, 2012 9:10 pm
by SandJ
Greyth wrote:
... OXP management system...
:!: There is a specific forum just for suggestions to the Oolite game called Suggestion Box.

Rather than tack suggestions onto this thread, which would be off-topic as it is about providing the user with directory names, you will have a greater chance of an on-topic review and discussion of your suggestion if you start another thread instead. :)

Re: Have the program tell the user what directories there ar

Posted: Sun Mar 25, 2012 9:12 pm
by Greyth
I do apologise SandJ, I didn't realise I was being rude. :oops:

Re: Have the program tell the user what directories there ar

Posted: Mon Mar 26, 2012 10:31 am
by Lone_Wolf
Sandj, looks like i focused to much on there being 1 path in your list of which i very much doubt the program knows where it is located, the path to the documentation.

the search path for oxps, path for logs and screendumps ARE known to the program.

1 comment about oxp search path :
apart from the addon folder, the Resources folder (/usr/share/oolite/Resources on my box) is also searched.
If we show that also, we should make clear what the difference is.
Maybe add a text like "used by oolite itself, NOT meant for user added oxps".