From 7cd9e3aadf2cb58fd6274b5d89a85a3b4491ceae Mon Sep 17 00:00:00 2001
From: onefang
Date: Fri, 23 Aug 2019 16:28:02 +1000
Subject: Update documentation.
Write some more.
Correct some spelling errors.
Clean up some out of date stuff.
Make it consistant.
Rearrange things.
---
CONTRIBUTORS.txt | 10 +--
Differences.txt | 10 +--
INSTALL.md | 118 +++++++++++++++++--------------
OpenSim/Framework/VersionInfo.cs | 2 +-
README.md | 143 +++-----------------------------------
bin/OpenSim.ini | 2 +-
bin/config-include/GridCommon.ini | 2 +-
coderDocs/TODO.txt | 18 ++---
doc/OpenSim_README.md | 122 ++++++++++++++++++++++++++++++++
doc/configuration.html | 8 +++
doc/index.html | 98 ++++++++++++++++++++++++++
doc/scripts.html | 8 +++
example/web/about.html | 2 +-
example/web/register.html | 2 +-
14 files changed, 336 insertions(+), 209 deletions(-)
create mode 100644 doc/OpenSim_README.md
create mode 100644 doc/configuration.html
create mode 100644 doc/index.html
create mode 100644 doc/scripts.html
diff --git a/CONTRIBUTORS.txt b/CONTRIBUTORS.txt
index f6a98a2..2ff4e9d 100644
--- a/CONTRIBUTORS.txt
+++ b/CONTRIBUTORS.txt
@@ -1,14 +1,14 @@
The following people have contributed to OpenSim (Thank you for your
effort!)
-= Current OpenSim-SC fork developers.
-These folks represent the current core team for OpenSim-SC fork, and are
-the people that make the day to day of OpenSim happen.
+= Current opensim-SC fork developers.
+These folks represent the current core team for opensim-SC fork, and are
+the people that make the day to day of opensim-SC happen.
* onefang rejected
-= Additional OpenSim-SC fork contributors =
-These folks have contributed code patches or content to OpenSim-SC fork
+= Additional opensim-SC fork contributors =
+These folks have contributed code patches or content to opensim-SC fork
to help make it what it is today.
* Taylor Temper
diff --git a/Differences.txt b/Differences.txt
index 9ae94d0..301cb68 100644
--- a/Differences.txt
+++ b/Differences.txt
@@ -1,19 +1,19 @@
-There are some differences between OpenSim-SC and standard OpenSim. The
+There are some differences between opensim-SC and standard OpenSim. The
most relevant ones are listed here.
-OpenSim-SC really only supports Debian based Linux operating systems at
+opensim-SC really only supports Debian based Linux operating systems at
this stage. Other operating systems, including Mac OS and Windows, will
be added in the future. Only Debian, Devuan, and Ubuntu have been
tested. Devuan ASCII is currently the best supported, as that's what I
use.
-OpenSim-SC is generally optimised for CG, IG, and MG grids.
+opensim-SC is generally optimised for CG, IG, and MG grids.
Directory layout.
-----------------
-OpenSim-SC expects to live inside a specific directory structure. The
+opensim-SC expects to live inside a specific directory structure. The
InstallItAll.sh script creates that directory structure. The external
directory structure is in the example/ directory. This tries to move
anything writable and configurable out of the main tree. Should make
@@ -87,7 +87,7 @@ Economy.
--------
The fake economy module has been faked even further, now your current
-balance displayed is the OpenSim_SC version number of the sim you are in.
+balance displayed is the opensim-SC version number of the sim you are in.
Obviously this is not a real economy, spending any of it doesn't deduct
from your balance. You can still install a real economy module.
diff --git a/INSTALL.md b/INSTALL.md
index 6b0d234..40bf35b 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -1,15 +1,10 @@
-NOTE - this is the OpenSim 0.9.0.1 version in the SledjChisl branch,
-which isn't quite ready yet. Use 0.8.2.1 in the master branch for the
-stable well tested version.
-
-
-Use this to create a sim that links into Infinite Grid or Misfitz Grid
-from Linux.
+Use this to create a sim that links into IG or MG grids from Linux. Or
+to run your own grid.
It's only been tested on Ubuntu 10.04, 11.04, 12.04, 16.04, as well as
-Debian 8, and Devuan 9, YMMV. This is also a WIP, use it at your own
-risk. It's been used to set up a few freshly installed servers though.
-It should work on recent Debian based Linux distros.
+Debian 8, Devuan 9, and Devuan 9. YMMV. This is also a WIP, use it at
+your own risk. It's been used to set up a few freshly installed servers
+though. It should work on recent Debian based Linux distros.
You may want to use the latest Mono, you can get it by following the
instructions at -
@@ -28,11 +23,11 @@ terminal, run the following command -
This will install the prerequisites (MariaDB, monit, MONO, tmux,
uuid-runtime); create a database in MariaDB called opensim_SC and a
database user called opensim_SC with a random password; add a Linux user
-to your system called opensimsc; create the /opt/opensim_SC directory to
-run it all from; copy everything to /opt/opensim_SC/opensim-SC_0.9.0.1;
-setup the directory structure needed to run it all; create some default
-configuration files; build OpenSim-SC; and finally change ownership and
-file permissions for everything.
+and group to your system called opensimsc; create the /opt/opensim_SC
+directory to run it all from; copy everything to
+/opt/opensim_SC/opensim-SC_0.9.0.1; setup the directory structure needed
+to run it all; create some default configuration files; build opensim-SC;
+and finally change ownership and file permissions for everything.
You will likely need to login your user again, so you get the new group
assigned to it. Otherwise the tmux stuff in start-sim might fail.
@@ -48,21 +43,26 @@ sudo ./create_sim.sh "My new sim" "1234,5678"
At this point /opt/opensim_SC/config/config.ini will be a symlink
pointing to config_localhost.ini, which is for a standalone sim. If you
-want your new random sim to be part of Infinite Grid (IG) or Misfitz Grid
-(MG) then you'll have to change that syml/ink to point to config_IG.ini or
-config_MG.ini respectively.
+want your new random sim to be part of IG or MG grids then you'll have to
+change that syml/ink to point to config_IG.ini or config_MG.ini
+respectively. There is no point doing that unless you are a member of
+those grids.
/opt/opensim_SC/config/sim01 now contains the actual configuration of
your randomly created sim. Edit the .ini file to make that sim a little
-less random.
+less random. You can even rename the .ini file to match your sim name.
+
+If you are running a grid run -
-Finally run -
+cd /opt/opensim_SC/config/ROBUSH
+./start-sim
+
+Then to actually startup your sim -
cd /opt/opensim_SC/config/sim01
./start-sim
-To actually startup your sim. And if you want to see the console of your
-sim run -
+And if you want to see the console of your sim run -
cd /opt/opensim_SC/current/scripts
./show-console
@@ -75,7 +75,7 @@ The various directories are -
.git Used by git for it's internal accounting, and the older versions.
-.nant Used by the nant build tool.
+.nant Used by the obsolete nant build tool.
OpenSim OpenSim source code.
@@ -113,20 +113,13 @@ db If you are not using MySQL, your data lives here.
logs Log files get stored here.
+web Web files go here. You can edit them to change the background image for example.
+
Follow these steps.
-------------------
-Go to -
-
-https://www.infinitegrid.org/drupal/content/How_to_link_your_OpenSim_region_to_Infinite_Grid_LinuxMySQL
-
-and follow the directions to create an admin user account. You can skip
-that bit if you already have a suitable user with sudo access.
-
-Note that these scripts pretty much follow that above wiki description,
-with some exceptions. The configuration information per sim has been
-rearranged so that there is only ONE copy of the OpenSim installation.
+First you need to have a user on your computer with sudo access.
Next you need to figure out what password you want to use for OpenSims
access to the database. We will call this "DatabasePassword". Run the
@@ -146,37 +139,45 @@ sims. You will need -
A name for your sim, we will use "My new sim". It should be unique on
the grid.
-Your host name, or it could be your IP, we will use "sims.example.net".
-
-A location for your sim, we will use "1234,5678". You can use the
-Infinite Grid web based map to poke around and find a good location.
-Choose an empty spot.
+A location for your sim, we will use "1234,5678". Choose an empty spot.
Once you have all that information sorted out, run this script from the
scripts/install directory -
./create_sim.sh "My new sim" "1234,5678" "sims.example.net"
-Or this if you want to override the detected IP address -
+Also, you can create a varregion with something like -
-./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4"
+./create_sim.sh "My new sim" "1234,5678" 512
-Also, you can create a varregion with something like -
+Note that the size has to be a multiple of 256, so 512, 768, 1024, etc.
+8096 is the maximum size, 2048 is about the biggest that is decently
+manageable.
-./create_sim.sh "My new sim" "1234,5678" "sims.example.net" "1.2.3.4" 512
-Note that the size has to be a multiple of 256, so 512, 768, 1024, etc.
+Running ROBUST.
+---------------
+
+If you are running your own grid, you need to start up ROBUST, which is
+a bunch of common services sims use. Go to /opt/opensim_SC/config/ROBUST
+and run the following script to start it up -
+
+./start-sim
+
+You will see the tmux console. You can run the tmux console again by
+running that command once more, or running the show-console script.
+
Running sims.
-------------
-Now you can go to /opt/opensim/config/sim01 and run the following script
+Now you can go to /opt/opensim_SC/config/sim01 and run the following script
to start it up -
./start-sim
-You will see the screen console. You can run the screen console again by
-running that command once more, or running the sim-console command.
+You will see the tmux console. You can run the tmux console again by
+running that command once more, or running the show-console script.
You can stop the sim with -
@@ -187,12 +188,23 @@ You can backup the sim with -
./backup-sim
+Running it all at once.
+-----------------------
+
+You don't have to run ROBUST, then each sim, you can run the lot at once.
+Go to /opt/opensim_SC/current/scripts and run -
+
+./start-sim
+
+It'll wait a minute between sims to give things time to settle down, and
+not over work your computer.
+
Finishing up.
-------------
Once it's all tested, you can use this to finish things off (back in
-the scripts directory) -
+the /opt/opensim_SC/current/scripts directory) -
./go_live.sh
@@ -201,14 +213,16 @@ it all, and you still have to do the basic configuration and enabling of
monit yourself. This is in case you already have monit set the way you
like.
+This step is entirely optional, and some versions of monit might not work
+so well.
+
NOTES -
This attempts to use only one copy of the OS install for all sims. We
are running one instance of OS for each sim though, as this prevents one
sim crashing from bringing down the others. OS however really wants to
-write data to directories within it's own bin directory. I'm not at all
-certain if that data can be shared. For the same reason, so far I've
-not been able to get to the point where we can make the OS directory
-read only. This complicates things during upgrades.
-
+write data to directories within it's own bin directory. The preferred
+way to update opensim-SC is to download a fresh copy, run BuildIt.sh,
+delete the installed copy, then copy this new one to where the old one
+used to be. I'll write an update script in the next version.
diff --git a/OpenSim/Framework/VersionInfo.cs b/OpenSim/Framework/VersionInfo.cs
index cf0a2a3..0780446 100644
--- a/OpenSim/Framework/VersionInfo.cs
+++ b/OpenSim/Framework/VersionInfo.cs
@@ -55,7 +55,7 @@ namespace OpenSim
public static string GetVersionString(string versionNumber, string buildNumber, Flavour flavour)
{
- string versionString = "OpenSim_SC " + versionNumber + " " + flavour + " build " + buildNumber;
+ string versionString = "opensim-SC " + versionNumber + " " + flavour + " build " + buildNumber;
return versionString.PadRight(VERSIONINFO_VERSION_LENGTH);
}
diff --git a/README.md b/README.md
index cc1a26e..c190f28 100644
--- a/README.md
+++ b/README.md
@@ -1,134 +1,9 @@
-WARNING!
-WARNING!
-
-This isn't complete yet, things are still very much in a state of flux.
-
-The scripts directory is still in need of major changes.
-
-You have been WARNED!
-
-WARNING!
-WARNING!
-
-
-
-Welcome to OpenSim!
-
-# Overview
-
-OpenSim is a BSD Licensed Open Source project to develop a functioning
-virtual worlds server platform capable of supporting multiple clients
-and servers in a heterogeneous grid structure. OpenSim is written in
-C#, and can run under Mono or the Microsoft .NET runtimes.
-
-This is considered an alpha release. Some stuff works, a lot doesn't.
-If it breaks, you get to keep *both* pieces.
-
-# OpenSim-SC
-
-OpenSim-SC is a fork of OpenSim. See the Differences.txt file for details.
-
-# Compiling OpenSim
-
-Please see BUILDING.md if you downloaded a source distribution and
-need to build OpenSim before running it.
-
-# Running OpenSim on Windows
-
-You will need .NET 4.0 installed to run OpenSimulator.
-
-We recommend that you run OpenSim from a command prompt on Windows in order
-to capture any errors.
-
-To run OpenSim from a command prompt
-
- * cd to the bin/ directory where you unpacked OpenSim
- * run OpenSim.exe
-
-Now see the "Configuring OpenSim" section
-
-# Running OpenSim on Linux
-
-You will need Mono >= 2.10.8.1 to run OpenSimulator. On some Linux distributions you
-may need to install additional packages. See http://opensimulator.org/wiki/Dependencies
-for more information.
-
-To run OpenSim, from the unpacked distribution type:
-
- * cd bin
- * mono OpenSim.exe
-
-Now see the "Configuring OpenSim" section
-
-# Configuring OpenSim
-
-When OpenSim starts for the first time, you will be prompted with a
-series of questions that look something like:
-
- [09-17 03:54:40] DEFAULT REGION CONFIG: Simulator Name [OpenSim Test]:
-
-For all the options except simulator name, you can safely hit enter to accept
-the default if you want to connect using a client on the same machine or over
-your local network.
-
-You will then be asked "Do you wish to join an existing estate?". If you're
-starting OpenSim for the first time then answer no (which is the default) and
-provide an estate name.
-
-Shortly afterwards, you will then be asked to enter an estate owner first name,
-last name, password and e-mail (which can be left blank). Do not forget these
-details, since initially only this account will be able to manage your region
-in-world. You can also use these details to perform your first login.
-
-Once you are presented with a prompt that looks like:
-
- Region (My region name) #
-
-You have successfully started OpenSim.
-
-If you want to create another user account to login rather than the estate
-account, then type "create user" on the OpenSim console and follow the prompts.
-
-Helpful resources:
- * http://opensimulator.org/wiki/Configuration
- * http://opensimulator.org/wiki/Configuring_Regions
-
-# Connecting to your OpenSim
-
-By default your sim will be available for login on port 9000. You can login by
-adding -loginuri http://127.0.0.1:9000 to the command that starts Second Life
-(e.g. in the Target: box of the client icon properties on Windows). You can
-also login using the network IP address of the machine running OpenSim (e.g.
-http://192.168.1.2:9000)
-
-To login, use the avatar details that you gave for your estate ownership or the
-one you set up using the "create user" command.
-
-# Bug reports
-
-In the very likely event of bugs biting you (err, your OpenSim) we
-encourage you to see whether the problem has already been reported on
-the [OpenSim mantis system](http://opensimulator.org/mantis/main_page.php).
-
-If your bug has already been reported, you might want to add to the
-bug description and supply additional information.
-
-If your bug has not been reported yet, file a bug report ("opening a
-mantis"). Useful information to include:
- * description of what went wrong
- * stack trace
- * OpenSim.log (attach as file)
- * OpenSim.ini (attach as file)
- * if running under mono: run OpenSim.exe with the "--debug" flag:
-
- mono --debug OpenSim.exe
-
-# More Information on OpenSim
-
-More extensive information on building, running, and configuring
-OpenSim, as well as how to report bugs, and participate in the OpenSim
-project can always be found at http://opensimulator.org.
-
-Thanks for trying OpenSim, we hope it is a pleasant experience.
-
-
+opensim-SC is a fork of OpenSim, and OpenSim is a clean room fork of
+Second Life. They are all 3D virtual worlds that are open, users can
+create their own content, these are not games. Second Life is a
+proprietary server, with open source viewer. OpenSim is an open source
+server that works with Second Life viewers.
+
+See doc/index.html for details. INSTALL.md for installation
+instructions. Differences.txt for the differences between OpenSim and
+opensim-SC. coderDocs/ for the coder level documentation.
diff --git a/bin/OpenSim.ini b/bin/OpenSim.ini
index bcbed2b..389b3f0 100644
--- a/bin/OpenSim.ini
+++ b/bin/OpenSim.ini
@@ -40,7 +40,7 @@
[Includes]
- ;; Uncomment this if using this for Misfitz Grid.
+ ;; Uncomment this if using this for MG.
; Include-Extra = "config-include/extra_MG.ini"
diff --git a/bin/config-include/GridCommon.ini b/bin/config-include/GridCommon.ini
index 394fa18..26accd9 100644
--- a/bin/config-include/GridCommon.ini
+++ b/bin/config-include/GridCommon.ini
@@ -1,5 +1,5 @@
; This is the main configuration file for an instance of OpenSim running in grid mode
-; In particular, this one is set up for connecting to Infinite Grid.
+; In particular, this one is set up for connecting to IG or MG.
[DatabaseService]
;
diff --git a/coderDocs/TODO.txt b/coderDocs/TODO.txt
index 2d53a2f..bd3c02a 100644
--- a/coderDocs/TODO.txt
+++ b/coderDocs/TODO.txt
@@ -1,4 +1,14 @@
+TODO on release-
+----------------
+Update version numbers.
+git log 8f280962f019d46e0367b29246283a1e34ceb955.. --pretty=format:"%s%n%b%n----------------" > NEWS.new
+ That'll be up to and excluding that revision.
+Clean that up, merge it into NEWS.
+Tag and release.
+
+
Still to do -
+-------------
Clean up the configs.
Why do we have Include-Common, Include-modules, Include-osslEnable, Include-Architecture, Include-Storage, Include-*Cache ??????
@@ -37,14 +47,6 @@ mono OpenSim.exe -inidirectory=/opt/opensim-0.9.0.1_MG/config/sim05
/usr/bin/mono /opt/opensim/current/bin/OpenSim.exe -logconfig=/opt/opensim/config/sim07/OpenSim.exe.config -inifile=/opt/opensim/config/OpenSim.ini -inidirectory=/opt/opensim/config/sim07
-Name
-----
-
-UnifiedKidsGrids
-SledjChisel, the version where we chisel away at OpenSim until it's all gone and is now SledjHamr. B-)
- SledjChisl?
-
-
Old TODO
--------
diff --git a/doc/OpenSim_README.md b/doc/OpenSim_README.md
new file mode 100644
index 0000000..59b7553
--- /dev/null
+++ b/doc/OpenSim_README.md
@@ -0,0 +1,122 @@
+# OpenSim-SC
+
+OpenSim-SC is a fork of OpenSim. See the index.html file for details.
+The rest of this file is the OpenSim README.md, some of which may be out
+of date.
+
+
+
+Welcome to OpenSim!
+
+# Overview
+
+OpenSim is a BSD Licensed Open Source project to develop a functioning
+virtual worlds server platform capable of supporting multiple clients
+and servers in a heterogeneous grid structure. OpenSim is written in
+C#, and can run under Mono or the Microsoft .NET runtimes.
+
+This is considered an alpha release. Some stuff works, a lot doesn't.
+If it breaks, you get to keep *both* pieces.
+
+# Compiling OpenSim
+
+Please see BUILDING.md if you downloaded a source distribution and
+need to build OpenSim before running it.
+
+# Running OpenSim on Windows
+
+You will need .NET 4.0 installed to run OpenSimulator.
+
+We recommend that you run OpenSim from a command prompt on Windows in order
+to capture any errors.
+
+To run OpenSim from a command prompt
+
+ * cd to the bin/ directory where you unpacked OpenSim
+ * run OpenSim.exe
+
+Now see the "Configuring OpenSim" section
+
+# Running OpenSim on Linux
+
+You will need Mono >= 2.10.8.1 to run OpenSimulator. On some Linux distributions you
+may need to install additional packages. See http://opensimulator.org/wiki/Dependencies
+for more information.
+
+To run OpenSim, from the unpacked distribution type:
+
+ * cd bin
+ * mono OpenSim.exe
+
+Now see the "Configuring OpenSim" section
+
+# Configuring OpenSim
+
+When OpenSim starts for the first time, you will be prompted with a
+series of questions that look something like:
+
+ [09-17 03:54:40] DEFAULT REGION CONFIG: Simulator Name [OpenSim Test]:
+
+For all the options except simulator name, you can safely hit enter to accept
+the default if you want to connect using a client on the same machine or over
+your local network.
+
+You will then be asked "Do you wish to join an existing estate?". If you're
+starting OpenSim for the first time then answer no (which is the default) and
+provide an estate name.
+
+Shortly afterwards, you will then be asked to enter an estate owner first name,
+last name, password and e-mail (which can be left blank). Do not forget these
+details, since initially only this account will be able to manage your region
+in-world. You can also use these details to perform your first login.
+
+Once you are presented with a prompt that looks like:
+
+ Region (My region name) #
+
+You have successfully started OpenSim.
+
+If you want to create another user account to login rather than the estate
+account, then type "create user" on the OpenSim console and follow the prompts.
+
+Helpful resources:
+ * http://opensimulator.org/wiki/Configuration
+ * http://opensimulator.org/wiki/Configuring_Regions
+
+# Connecting to your OpenSim
+
+By default your sim will be available for login on port 9000. You can login by
+adding -loginuri http://127.0.0.1:9000 to the command that starts Second Life
+(e.g. in the Target: box of the client icon properties on Windows). You can
+also login using the network IP address of the machine running OpenSim (e.g.
+http://192.168.1.2:9000)
+
+To login, use the avatar details that you gave for your estate ownership or the
+one you set up using the "create user" command.
+
+# Bug reports
+
+In the very likely event of bugs biting you (err, your OpenSim) we
+encourage you to see whether the problem has already been reported on
+the [OpenSim mantis system](http://opensimulator.org/mantis/main_page.php).
+
+If your bug has already been reported, you might want to add to the
+bug description and supply additional information.
+
+If your bug has not been reported yet, file a bug report ("opening a
+mantis"). Useful information to include:
+ * description of what went wrong
+ * stack trace
+ * OpenSim.log (attach as file)
+ * OpenSim.ini (attach as file)
+ * if running under mono: run OpenSim.exe with the "--debug" flag:
+
+ mono --debug OpenSim.exe
+
+# More Information on OpenSim
+
+More extensive information on building, running, and configuring
+OpenSim, as well as how to report bugs, and participate in the OpenSim
+project can always be found at http://opensimulator.org.
+
+Thanks for trying OpenSim, we hope it is a pleasant experience.
diff --git a/doc/configuration.html b/doc/configuration.html
new file mode 100644
index 0000000..9844414
--- /dev/null
+++ b/doc/configuration.html
@@ -0,0 +1,8 @@
+
+opensim-SC configuration documentation
+
+
+
+
+
+
diff --git a/doc/index.html b/doc/index.html
new file mode 100644
index 0000000..41080e1
--- /dev/null
+++ b/doc/index.html
@@ -0,0 +1,98 @@
+
+opensim-SC documenation
+
+
+
+What is opensim-SC?
+
+opensim-SC is a fork of OpenSim, and OpenSim
+is a clean room fork of Second Life. They
+are all 3D virtual worlds that are open, users can create their own
+content, these are not games. Second Life is a proprietary server, with
+open source viewer. OpenSim is an open source server that works with
+Second Life viewers.
+
+The SC in opensim-SC stands for SledjChisl, part of the SledjHamr project.
+
+
+
+What is SledjHamr?
+
+opensim-SC is part of the SledjHamr project. SledjHamr is a rewrite from
+scratch of Second Life (SL) / OpenSim (OS) style 3D online virtual world
+client / server. The plan is to use OS server and SL clients as crutches,
+when a bit of SledjHamr is ready, it replaces the matching bit in OS/SL.
+
+SledjHamr - tearing down the garden walls.
+
+
+What is SledjChisl?
+
+While OpenSim is slowly morphing into SledjHamr, it needed a name, so
+I called it SledjChisl. The main differences between opensim-SC and
+OpenSim are listed in Differences.txt
+
+SledjChisl - chipping away at OpenSim until it's all gone, and is now SledjHamr.
+
+
+Enough of the bad puns, what is it all about?
+
+It's a 3D open online shared virtual world that is user created. Using a
+specialised bit of software called a viewer you log onto one of these
+worlds, either Second Life, or one of the many OpenSim based worlds. You
+then get to wander around a 3D world that the other users have built,
+and do many things. Including building your own bit of the world using
+the viewer itself.
+
+It's not a game.
+
+Many people think of it as a game, but it's missing many of the features
+of a real game, and tends to be more about the social side of things.
+I've even had someone tell me that everything online is a game, even
+pointing out that their bank account is online didn't help. There is no
+goal, no game play, no levelling up, no one keeps score. You do what you
+want in these worlds (within the limits of the local rules), and that
+might include playing games that people have created in the world, but
+you don't have to.
+
+People even do business in them.
+
+
+What do I do with opensim-SC?
+
+The easiest thing to do is to just join a world that is running
+opensim-SC, but you don't need this software for doing that. This
+software is for running such a world, or part of it.
+
+Virtual world software is complex software, coz you are simulating an
+entire world. There's lots of things to take care of. While SledjHamr
+aims to make things as simple as possible for ordinary folk, we ain't
+there yet. opensim-SC is slightly easier to setup than OpenSim, so
+progress has been made. opensim-SC tries to remain compatible, so for
+more details, refer to the OpenSim and Second Life
+documentation.
+
+You'll need to be familiar with command lines. Currently opensim-SC uses
+Linux shell scripts, though that'll change in the next release to be more
+portable to other operating systems. The shell scripts are for setup and
+basic management, the virtual world software itself is written in
+portable C# that runs on .NET and MONO.
+
+The scripts install and manage everything based on a Debian variation
+of Linux, it's been tested under Debian, Devuan, and Ubuntu. Refer to
+INSTALL.md for installation details.
+
+The scripts are documented here.
+
+The new configuration setup and options are documented here.
+
+
+
+
+
+
diff --git a/doc/scripts.html b/doc/scripts.html
new file mode 100644
index 0000000..55b8d26
--- /dev/null
+++ b/doc/scripts.html
@@ -0,0 +1,8 @@
+
+opensim-SC scripts documentation
+
+
+
+
+
+
diff --git a/example/web/about.html b/example/web/about.html
index e45f00a..b558e39 100644
--- a/example/web/about.html
+++ b/example/web/about.html
@@ -3,7 +3,7 @@
-This is a virtual world, usually called a grid, based on OpenSim_SC.
+This is a virtual world, usually called a grid, based on opensim-SC.