Lost Souls directory structure
From LSWiki
(Difference between revisions)
Revision as of 18:53, 9 January 2007 (edit) Msb (Talk | contribs) ← Previous diff |
Revision as of 18:58, 9 January 2007 (edit) Msb (Talk | contribs) Next diff → |
||
Line 3: | Line 3: | ||
This page is going to need a lot more work, but it's worthwhile work, especially since I don't actually the actual organizational principles behind half this stuff. | This page is going to need a lot more work, but it's worthwhile work, especially since I don't actually the actual organizational principles behind half this stuff. | ||
- | ==/d== | + | *'''/d''' This is where the world is. The "d" stands for "domain", which apparently used to mean something. Chaos claims that this stands for "deployed", but we all know he's a dirty liar. |
- | This is where the world is. The "d" stands for "domain", which apparently used to mean something. Chaos claims that this stands for "deployed", but we all know he's a dirty liar. | + | *:Read access [[privilege]]*: [[read_d]] |
- | :Read access [[privilege]]: [[read_d]] | + | *:Write access [[privilege]]*: [[write_d]] |
- | :Write access [[privilege]]: [[write_d]] | + | |
- | *'''/d/Affiliations''' This is where affiliations (associations, guilds, offices, racial and other faculties). | + | **'''/d/Affiliations''' This is where affiliations (associations, guilds, offices, racial and other faculties). |
- | ::Read access [[privilege]]: [[read_sensitive]] | + | **:Read access [[privilege]]*: [[read_sensitive]] |
- | ::Write access [[privilege]]: [[write_sensitive]] | + | **:Write access [[privilege]]*: [[write_sensitive]] |
- | *'''/d/Almeria''' This is where the main map and the main world is, though it's all in subdirectories. Take a look, it should be pretty clear. | + | **'''/d/Almeria''' This is where the main map and the main world is, though it's all in subdirectories. Take a look, it should be pretty clear. |
- | *'''/d/System''' This is where Bytehaven is, which is an area with a few handy developer bits like the test character register, and the Banishment tablet. There is also a project called Public that has some 'utility' rooms. | + | **'''/d/System''' This is where Bytehaven is, which is an area with a few handy developer bits like the test character register, and the Banishment tablet. There is also a project called Public that has some 'utility' rooms. |
- | *'''/d/Misc''' Things that don't belong elsewhere, like projects that are primarily about items (Lzrelekoi) or wandering areas (the Vanishing Tower). | + | **'''/d/Misc''' Things that don't belong elsewhere, like projects that are primarily about items (Lzrelekoi) or wandering areas (the Vanishing Tower). |
- | *'''/d/(various planes)''' Like Almeria, except not on Almeria. | + | **'''/d/(various planes)''' Like Almeria, except not on Almeria. |
- | ==/daemon== | + | *'''/daemon''' This is where daemons are. What are daemons you ask? Good question. Basically I think they are objects that control, handle, and store data. Right? |
- | This is where daemons are. What are daemons you ask? Good question. Basically I think they are objects that control, handle, and store data. Right? | + | *:Read access [[privilege]]*: [[read_lib]] |
- | :Read access [[privilege]]: [[read_lib]] | + | *:Write access [[privilege]]*: [[write_lib]] |
- | :Write access [[privilege]]: [[write_lib]] | + | |
- | ==/def== | + | *'''/def''' This is where definition files reside. Definitions are abstract files that determine certain generic properties of particular files. Races, anatomies, weapon types, damage types, are all examples of things that have definitions. |
- | This is where definition files reside. Definitions are abstract files that determine certain generic properties of particular files. Races, anatomies, weapon types, damage types, are all examples of things that have definitions. | + | *:Read access [[privilege]]*: [[read_lib]] |
- | :Read access [[privilege]]: [[read_lib]] | + | *:Write access [[privilege]]*: [[write_lib]] |
- | :Write access [[privilege]]: [[write_lib]] | + | |
- | ==/etc== | + | *'''/etc''' A few general lib files are here, like item.h |
- | A few general lib files are here, like item.h | + | |
- | ==/lib== | + | *'''/lib''' More particular, but still very general, lib files are here. Project lib files can usually be found in /d/Almeria/lib, or /d/Affiliations/lib, or something of that sort. |
- | More particular, but still very general, lib files are here. Project lib files can usually be found in /d/Almeria/lib, or /d/Affiliations/lib, or something of that sort. | + | *:Read access [[privilege]]*: [[read_lib]] |
- | :Read access [[privilege]]: [[read_lib]] | + | *:Write access [[privilege]]*: [[write_lib]] |
- | :Write access [[privilege]]: [[write_lib]] | + | |
- | *'''/lib/dev''' This is where developer work-in-progress lib files go; everyone has write access to this directory. | + | **'''/lib/dev''' This is where developer work-in-progress lib files go; everyone has write access to this directory. |
- | ::Read access [[privilege]]: [[standard]] | + | **:Read access [[privilege]]*: [[standard]] |
- | ::Write access [[privilege]]: [[standard]] | + | **:Write access [[privilege]]*: [[standard]] |
- | *'''/lib/descriptors''' This is where the header files that are automatically generated by the descriptor definitions in /def/descriptor are kept. Most header files are manually maintained; these are unusual in being created by the system. | + | **'''/lib/descriptors''' This is where the header files that are automatically generated by the descriptor definitions in /def/descriptor are kept. Most header files are manually maintained; these are unusual in being created by the system. |
- | ==/mod== | + | *'''/mod''' This hierarchy contains component modules, mainly to be assembled into complete inheritables by things in /std. |
- | This hierarchy contains component modules, mainly to be assembled into complete inheritables by things in /std. | + | *:Read access [[privilege]]*: [[read_lib]] |
- | :Read access [[privilege]]: [[read_lib]] | + | *:Write access [[privilege]]*: [[write_lib]] |
- | :Write access [[privilege]]: [[write_lib]] | + | |
- | ==/obj== | + | */obj This hierarchy mainly contains files that are intended to be physical objects in the game world; weapons, armour, comestibles, and so on. There are a few special cases. |
- | This hierarchy mainly contains files that are intended to be physical objects in the game world; weapons, armour, comestibles, and so on. There are a few special cases. | + | *:Read access [[privilege]]*: [[read_lib]] |
- | :Read access [[privilege]]: [[read_lib]] | + | *:Write access [[privilege]]*: [[write_lib]] |
- | :Write access [[privilege]]: [[write_lib]] | + | |
- | *'''/obj/extensions''' This is where standard system-wide extension objects are kept. Extensions are a way of loading functionality onto objects using attached, subsidiary objects; for instance, all weapon functionality is tracked by a weapon extension. This allows any object to be treated as an improvised weapon if need be. | + | **'''/obj/extensions''' This is where standard system-wide extension objects are kept. Extensions are a way of loading functionality onto objects using attached, subsidiary objects; for instance, all weapon functionality is tracked by a weapon extension. This allows any object to be treated as an improvised weapon if need be. |
- | *'''/obj/interfaces''' System-level input dialog interfaces are kept here. These are objects whose purpose is to handle an interactive dialog; the best example is /obj/interfaces/creation.c, which is the character generation interface. | + | **'''/obj/interfaces''' System-level input dialog interfaces are kept here. These are objects whose purpose is to handle an interactive dialog; the best example is /obj/interfaces/creation.c, which is the character generation interface. |
- | *'''/obj/master''' This is where things like the master object and the simul_efun object are kept -- crucial system things. | + | **'''/obj/master''' This is where things like the master object and the simul_efun object are kept -- crucial system things. |
- | ::Read access [[privilege]]: [[read_secure]] | + | **:Read access [[privilege]]*: [[read_secure]] |
- | ::Write access [[privilege]]: [[write_secure]] | + | **:Write access [[privilege]]*: [[write_secure]] |
- | ==/pub== | + | *'''/pub''' This is a public directory hierarchy where files can be exchanged and freely edited, and so on. One interesting subdirectory is /pub/defunct, where we generally put the /w directories of former developers. |
- | This is a public directory hierarchy where files can be exchanged and freely edited, and so on. One interesting subdirectory is /pub/defunct, where we generally put the /w directories of former developers. | + | *:Read access [[privilege]]*: [[read]] |
- | :Read access [[privilege]]: [[read]] | + | *:Write access [[privilege]]*: [[standard]] |
- | :Write access [[privilege]]: [[standard]] | + | |
- | ==/std== | + | *'''/std''' |
- | ==/sys== | + | |
- | ==/tmp== | + | |
- | A public directory for temporary files. Files in this directory are cleared out periodically. | + | |
- | :Read access [[privilege]]: [[read]] | + | |
- | :Write access [[privilege]]: [[standard]] | + | |
- | ==/txt== | + | *'''/sys''' |
- | ==/usr== | + | |
- | User files, mainly incarnos and kept-item save files, are in this hierarchy. | + | |
- | :Read access [[privilege]]: [[player_files]] | + | |
- | :Write access [[privilege]]: [[player_files]] | + | |
- | ==/w== | + | *'''/tmp''' A public directory for temporary files. Files in this directory are cleared out periodically. |
- | This is where developer workspaces go; your personal directory, ''/w/yourname'', is under this hierarchy. Originally the 'w' stood for 'wizard', back when we used such ill-advised terminology for developers, and the whole 'workspace' thing is just so we don't have to change the directory name. | + | *:Read access [[privilege]]*: [[read]] |
- | :Read access [[privilege]]: [[read_w]] | + | *:Write access [[privilege]]*: [[standard]] |
- | :Write access [[privilege]]: [[write_w]] | + | |
+ | *'''/txt''' | ||
+ | *'''/usr''' User files, mainly incarnos and kept-item save files, are in this hierarchy. | ||
+ | *:Read access [[privilege]]*: [[player_files]] | ||
+ | *:Write access [[privilege]]*: [[player_files]] | ||
+ | |||
+ | *'''/w''' This is where developer workspaces go; your personal directory, ''/w/yourname'', is under this hierarchy. Originally the 'w' stood for 'wizard', back when we used such ill-advised terminology for developers, and the whole 'workspace' thing is just so we don't have to change the directory name. | ||
+ | *:Read access [[privilege]]*: [[read_w]] | ||
+ | *:Write access [[privilege]]*: [[write_w]] |
Revision as of 18:58, 9 January 2007
This structure of this file mirror the LS directory structure. If you don't know how to navigate the directory structure, please read the Developer Primer.
This page is going to need a lot more work, but it's worthwhile work, especially since I don't actually the actual organizational principles behind half this stuff.
- /d This is where the world is. The "d" stands for "domain", which apparently used to mean something. Chaos claims that this stands for "deployed", but we all know he's a dirty liar.
- /d/Affiliations This is where affiliations (associations, guilds, offices, racial and other faculties).
- Read access privilege*: read_sensitive
- Write access privilege*: write_sensitive
- /d/Almeria This is where the main map and the main world is, though it's all in subdirectories. Take a look, it should be pretty clear.
- /d/System This is where Bytehaven is, which is an area with a few handy developer bits like the test character register, and the Banishment tablet. There is also a project called Public that has some 'utility' rooms.
- /d/Misc Things that don't belong elsewhere, like projects that are primarily about items (Lzrelekoi) or wandering areas (the Vanishing Tower).
- /d/(various planes) Like Almeria, except not on Almeria.
- /d/Affiliations This is where affiliations (associations, guilds, offices, racial and other faculties).
- /daemon This is where daemons are. What are daemons you ask? Good question. Basically I think they are objects that control, handle, and store data. Right?
- /def This is where definition files reside. Definitions are abstract files that determine certain generic properties of particular files. Races, anatomies, weapon types, damage types, are all examples of things that have definitions.
- /etc A few general lib files are here, like item.h
- /lib More particular, but still very general, lib files are here. Project lib files can usually be found in /d/Almeria/lib, or /d/Affiliations/lib, or something of that sort.
- /lib/dev This is where developer work-in-progress lib files go; everyone has write access to this directory.
- /lib/descriptors This is where the header files that are automatically generated by the descriptor definitions in /def/descriptor are kept. Most header files are manually maintained; these are unusual in being created by the system.
- /mod This hierarchy contains component modules, mainly to be assembled into complete inheritables by things in /std.
- /obj This hierarchy mainly contains files that are intended to be physical objects in the game world; weapons, armour, comestibles, and so on. There are a few special cases.
- /obj/extensions This is where standard system-wide extension objects are kept. Extensions are a way of loading functionality onto objects using attached, subsidiary objects; for instance, all weapon functionality is tracked by a weapon extension. This allows any object to be treated as an improvised weapon if need be.
- /obj/interfaces System-level input dialog interfaces are kept here. These are objects whose purpose is to handle an interactive dialog; the best example is /obj/interfaces/creation.c, which is the character generation interface.
- /obj/master This is where things like the master object and the simul_efun object are kept -- crucial system things.
- Read access privilege*: read_secure
- Write access privilege*: write_secure
- /pub This is a public directory hierarchy where files can be exchanged and freely edited, and so on. One interesting subdirectory is /pub/defunct, where we generally put the /w directories of former developers.
- /std
- /sys
- /tmp A public directory for temporary files. Files in this directory are cleared out periodically.
- /txt
- /usr User files, mainly incarnos and kept-item save files, are in this hierarchy.
- Read access privilege*: player_files
- Write access privilege*: player_files
- /w This is where developer workspaces go; your personal directory, /w/yourname, is under this hierarchy. Originally the 'w' stood for 'wizard', back when we used such ill-advised terminology for developers, and the whole 'workspace' thing is just so we don't have to change the directory name.