################################################################################ # ############ . * . ############ # # ############ (SALEM) Salem README ############ # # ############ ^^^ ############ # ################################################################################ Listed below are the contents and descriptions of the SALEM subdistribution of Witch City Linux, Mercy Lewis Branch. Bewitch Module Packing List --------------------------- Bewitch houses 22 modules in /usr/lib/WCL. Below is the list and a brief description of each: 1) A-BUILDER_: WCL Homestead creation. 2) B-SWEEPER_: Bewitch clean-up. 3) B-WCLDATA_: Data structures, narratives, and other miscellaneous assignments. 4) BEWITCH_ : Bewitch Extension Module. Pre-processing, processing, staging, configuration, post-processing, and lift-off. 5) C-ANALYST_: Session profiling, identification, and other examination. 6) C-COURIER_: Shipment order delivery. 7) C-DESTINY_: XDG X11 Directory Creation and Removal. 8) C-EFFECTS_: Desktop visuals and eye candy. 9) C-EXPORTS_: Global Exports. 10) C-IMAGING_: Desktop Background Imaging and Shading. 11) C-IMPORTS_: Sources, Xresources, Xmodmaps, profiles, Xprofiles, and preferred imports. 12) C-MANAGER_: Coordinates session startup, allocates the work, and prepares the requisition. 13) C-PACKING_: Standard Package Processing and Order Filling. 14) C-PATCHES_: Dirty Fixes For WM Imaging (mostly), and other barriers that arise. 15) C-RECEIVE_: Receiving, processing, and preparing of work order. 16) C-SHIPPER_: Bewitch requisition processor. 17) C-SMAGENT_: Shipment Mailing Agent. Prepares and writes out the order that will be delivered to shipping. 18) C-UTILITY_: Startup services and utilities. 19) D-DIALOGS_: Pre-processing, processing, and post-processing documenter. 20) D-LOGGING_: Directory, logue, and narrative creation. Bewitch module load. 21) D-NUMBERS_: Calculation. 22) D-PRINTER_: Processing Manifest and related narratives. Dashboard Modules Packing List ------------------------------ There are 4 modules in /usr/lib/WCL/dashboard. These are used to display the WCL scripture dashboard for user navigation, and are as follows: 1) FAILURE_: Dashboard Error Handling. 2) TTYMENU_: Navigation of WCL Scripture Console (tty1). 3) TWMMENU_: Navigation of TWM's WCL Scripture Environment. 4) WCLMENU_: Navigation of WCL Scripture Environment. Dispatch Modules Packing List ---------------------------- There are 6 modules in /usr/lib/WCL/dispatch. Below is the list and a brief description of each: 1) DEAD_SESSION_: Error Handling. 2) ENVIRONMENTS_: Adapts the session to the current X or console environment. 3) FRESH_REVEAL_: Prepares a new desktop environment. 4) LIVE_SESSION_: Launches the current desktop environment. 5) PRIOR_REVEAL_: Prepares the previous desktop environment. 6) XDM_SESSIONS_: Handles XDM sessioning for Salem. XDM Modules Packing List ------------------------ There are 7 modules or files in /usr/lib/WCL/xdm. Below is the list and a brief description of each: FAILSAFE_ : Stops XDM and exits in the event of erroneous ownership assignment. PRESENTATION: Settings for WCL-XDM Login Screen. Resource.db : Xresources for XDM Login Presentation Screen TERMINATE_ : Kills programs started at login. Xaccess : Dummy file. xdmrc : XDM configuration file for WCL/Salem. Xserver : The server for the local display. Xinit Modules Packing List ------------------------ There are 5 modules in /usr/lib/WCL/xinit. Below is the list and a brief description of each: AUTHENTICATION_: Authorization keys creation for wcl-xinit. CLIENT_SIDE_ : Configuration of wcl-xinit's client arguments HOUSEKEEPING_ : Thorough clean-up of wcl-xinit. MAIN_CALL_ : Central processing of wcl-xinit. SERVER_SIDE_ : Configuration of wcl-xinit's server arguments, and activation of xserver. Scripture Modules Packing List ------------------------------ There are 20 scripts in /usr/lib/WCL/scripture. Below is the list and a brief description of each: 1) wcl-bewitch : WCL Desktop Environment and Xstartup Coordinator. 2) wcl-bewitch_aXe : Exits the WCL Desktop Environment by killing the PID of a desktop session, and each of its xstartups. 3) wcl-bewitch_broomstick : An app starter for evilwm. 4) wcl-bewitch_compositor : Switches Xcompositing On/Off. Different approaches can be requested. 5) wcl-bewitch_dispatch : Routes a Bewitch desktop session from a console (tty1), or display manager. 6) wcl-bewitch_manifest : Displays the current Montgomery Logue (Processing Manifest). 7) wcl-bewitch_witchcake : NEW! Bewitch-on-demand. Purge, Stage/Transport, and view bundles. 8) wcl-salem : Salem Dashboard presentation 9) wcl-salem_dock : Sets up some launchers and starts the Plank dock. 10) wcl-salem_lure : M3U8 Playlist Formatter 11) wcl-salem_snapshot : Takes a fullscreen desktop screenshot. 12) wcl-salem_twm : Twmrc color-scheme configuration. 13) wcl-salem_update : Combines Reflector and Pacman to update your Arch Linux. 14) wcl-xdm : An elaborate replacement of the standard Xsetup script for XDM. 15) wcl-xdm_assign : WCL-XDM's Xstartup script. 16) wcl-xdm_reclaim : WCL-XDM's Xreset script. 17) wcl-xdm_session : A simple script the sets the next desktop session for XDM in-session. 18) wcl-xdm_setup : Launches wcl-xdm in the background. 19) wcl-xinit: : WCL's 'startx' alternative. This is the only xinit script that Salem uses now. 20) wcl-xinit_x : A near-replicant script, traditionally referred to as "xserverrc". 21) wcl-salem_xmanuals : This one-line hack bypasses the xman error. Common Packing List ------------------- The share/WCL folder contains the following items related to Bewitch: 1) sessionrc : The Bewitch session configuration file. 2) environrc : Yet another place for global exports. 3) broomstix : Configuration for wcl-broomstick. 4) broomstix.db: Xresources for wcl-broomstick. 5) wallpaper : The Bewitch desktop background images. Salem_Circle-Blue.png Salem_Circle-Bright_Blue.png Salem_Circle-Dim_Blue.png Salem_Circle-Dim_Gray.png Salem_Circle-Gray.png Salem_Circle-Green.png Salem_Circle-Red.png Salem_Circle-Slate.png Salem_Circle-White.png Salem-Full_Moon-Blue.png Salem-Full_Moon-Bright_Blue.png Salem-Full_Moon-Dim_Blue.png Salem-Full_Moon-Dim_Gray.png Salem-Full_Moon-Gray.png Salem-Full_Moon-Green.png Salem-Full_Moon-Red.png Salem-Full_Moon-Slate.png Salem-Full_Moon-White.png Salem-Blue.png Salem-Bright_Blue.png Salem-Dim_Blue.png Salem-Dim_Gray.png Salem-Gray.png Salem-Green.png Salem-Red.png Salem-Slate.png Salem-White.png 6) XDM: XDM login screen aesthetics. Bewitch-Silhouette.xpm Salem_Harbor.jpg Witch_House.jpg 7) Application .desktop files: wcl-aXe.desktop wcl-compositor.desktop wcl-manifest.desktop wcl-snapshot.desktop wcl-xmanuals.desktop 8) Icons: wcl-tabitha.png wcl-aXe.png wcl-compositor.png wcl-manifest.png wcl-snapshot.png wcl-xmanuals.png Getting Started --------------- Everything you need to know is contained in the DOCUMENTATION and README folders of this download. "SESSIONRC" will explain how to set everything up for a session. There is an example setups in the sessionrc file for Twm that should give you a decent idea on how things are easily configured. If you are missing any programs that are scheduled to start in the sessionrc file, the Montgomery Logue (processing manifest) will document which ones they are. "ENVIRONRC" supplies an alternative method to exporting your global environment variables. "BEWITCHING" will tell you how to start Bewitch from the "evil" command line (startx), as well as from some popular display managers. "TWM_SCHEMES" explains how to easily create your own Twm color schemes. Thirty Twm color schemes accompany the Mary Sibley branch installation. "WITCH-CAKES" explains how the bundling process works on startup. "BROOMSTIX" and "BROOMSTIXDB" illustrate the configuration for wcl-broomstick. "WCL-XDM" details how to run our special version of XDM. "Tabitha" discusses how Twm is uniquely approached in Salem. "Lure" illustrates how to create your own playlists. Changes and Features are listed in within the SCROLLS folder. ################################################################################ # ############ . * . ############ # # ############ (SALEM) Salem README ############ # # ############ ^^^ ############ # ################################################################################