Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Finish up 1.0.8 docs.
  • Loading branch information
pudge committed Aug 18, 2000
1 parent 928c34a commit 79c0aed
Show file tree
Hide file tree
Showing 10 changed files with 1,268 additions and 798 deletions.
3 changes: 2 additions & 1 deletion Bundle/README
@@ -1,2 +1,3 @@
This is a Bundle file for Slash, the code that runs Slashdot. See This is a Bundle file for Slash, the code that runs Slashdot. See
http://slashcode.com/ for more information. http://slashcode.com/ or http://www.sourceforge.net/projects/slashcode/
for more information.
3 changes: 2 additions & 1 deletion Bundle/Slash.pm
@@ -1,6 +1,6 @@
package Bundle::Slash; package Bundle::Slash;


$Bundle::Slash::VERSION = '1.0.7'; $Bundle::Slash::VERSION = '1.0.8';


1; 1;


Expand All @@ -10,6 +10,7 @@ __END__
Bundle::Slash - A bundle to install all modules used for Slash Bundle::Slash - A bundle to install all modules used for Slash
=head1 SYNOPSIS =head1 SYNOPSIS
C<perl -MCPAN -e 'install "Bundle::Slash"'> C<perl -MCPAN -e 'install "Bundle::Slash"'>
Expand Down
520 changes: 251 additions & 269 deletions INSTALL

Large diffs are not rendered by default.

112 changes: 54 additions & 58 deletions README
Expand Up @@ -2,72 +2,69 @@ NAME
README - Slashdot Readme README - Slashdot Readme


DESCRIPTION DESCRIPTION
This is the README file for Slash, release 1.0.7. Please read This is the README file for Slash, release 1.0.8. Please read all
all documentation carefully. The various documents explain the documentation carefully. The various documents explain the database
database schema, the various fields in the database, and some of schema, the various fields in the database, and some of the reasoning
the reasoning behind the design of the schema, installation and behind the design of the schema, installation and setup.
setup.

Please see INSTALL for database upgrade instructions. Code upgrading is
Please see INSTALL for database upgrade instructions. Code simple: use the new code in the new distribution, and make sure that you
upgrading is simple: use the new code in the new distribution, have the new values and configurations in your copies of slashdotrc.pl
and make sure that you have the new values and configurations in and httpd.conf. If you neglect to upgrade these last two, your site
your copies of slashdotrc.pl and httpd.conf. If you neglect to likely will not work.
upgrade these last two, your site likely will not work.

Also, double-check every line of CHANGES to see if anything has changed
Also, double-check every line of CHANGES to see if anything has to affect your site (like a change from Mail::Sender to Mail::Sendmail,
changed to affect your site (like a change from Mail::Sender to for example).
Mail::Sendmail, for example).

Note: This page looks best in a browser (the HTML version of it is in
Note: This page looks best in a browser (the HTML version of it the docs/ directory). You can print it out, but some of the ASCII
is in the docs/ directory). You can print it out, but some of illustrations may get munged in printing, but the directions will
the ASCII illustrations may get munged in printing, but the certainly appear good enough to read.
directions will certainly appear good enough to read.


We have a preliminary Getting Started document at We have a preliminary Getting Started document at
public_html/getting_started.shtml. If this is your first time public_html/getting_started.shtml. If this is your first time with
with Slash, or you have questions or problems getting started, Slash, or you have questions or problems getting started, look here
look here first. first.


See the Slash web site, with support, docs, latest downloads, See the Slash web site, with support, docs, latest downloads, FAQs, and
FAQs, and more, at <URL:http://slashcode.com/>. more, at <URL:http://slashcode.com/>.


This release is tagged in CVS as v1_0_7_0. See the SourceForge This release is tagged in CVS as v1_0_8_0. See the SourceForge site at
site at http://sourceforge.net/projects/slashcode/ for CVS, bug <http://sourceforge.net/projects/slashcode/> for CVS, bug reporting,
reporting, patch submissions, and downloads. patch submissions, and downloads.


What is Slash? What is Slash?


Maybe this is a dumb question, but why not get this answered? Maybe this is a dumb question, but why not get this answered? Slash is a
Slash is a database-driven news and message board, using database-driven news and message board, using mod_perl and MySQL. It has
mod_perl and MySQL. It has been programmed, more so recently, to been programmed, more so recently, to use persistance for a good deal of
use persistance for a good deal of its variables to increase its variables to increase speed and efficiency. Slash has all the
speed and efficiency. Slash has all the features and more that features and more that you'd ever want in a bulletin-board/message-board
you'd ever want in a bulletin-board/message-board system. You system. You can customize it to anything you want, give it any
can customize it to anything you want, give it any appearance appearance that you want. This can mostly be done via data. Slash is a
that you want. This can mostly be done via data. Slash is a database beast in the true sense. The Slash code is distributed under
database beast in the true sense. The Slash code is distributed the GNU General Public License (see COPYING).
under the GNU General Public License (see COPYING).


Hardware/Software Hardware/Software


The live Slashdot used five separate servers for its high hit The live Slashdot used five separate servers for its high hit count.
count. This is not a target number for all Slash sites. You can This is not a target number for all Slash sites. You can run all of
run all of Slash on one server, or throw it on 20 servers. The Slash on one server, or throw it on 20 servers. The more load you want
more load you want it to handle, the more hardware you'll want. it to handle, the more hardware you'll want. Slash consists of three
Slash consists of three main parts: database, codebase, and web main parts: database, codebase, and web server. How those are divvied up
server. How those are divvied up amongst servers is up to your amongst servers is up to your own creative planning. Slash runs on Linux
own creative planning. Slash runs on Linux but is not Linux but is not Linux specific. Whatever runs Apache/mod_perl and MySQL will
specific. Whatever runs Apache/mod_perl and MySQL will run run Slash. Slash does have some MySQL-specific SQL statements contained
Slash. Slash does have some MySQL-specific SQL statements within, but it's not entirely impossible to run it on another RDBMS with
contained within, but it's not entirely impossible to run it on some modifications.
another RDBMS with some modifications.


Documentation Documentation


Please read the various documents that come with the Slash code Please read the various documents that come with the Slash code (in
(in docs/). There's a lot of information that can give you a docs/). There's a lot of information that can give you a better idea of
better idea of what the code does, how to install the code, and what the code does, how to install the code, and other information on
other information on the database schema. the database schema.


README README
this document (POD, HTML and plaintext) this document (POD, HTML and plaintext)
Expand All @@ -76,17 +73,16 @@ DESCRIPTION
how to install (POD, HTML and plaintext) how to install (POD, HTML and plaintext)


slasherd.fig slasherd.fig
the ERD diagram of the Slash database schema (use xfig to the ERD diagram of the Slash database schema (use xfig to read it)
read it)


slashtables.html/sdw/ps slashtables.html/sdw/ps
a description of all the tables and columns of the database a description of all the tables and columns of the database schema
schema (HTML, StarOffice, and PostScript) (HTML, StarOffice, and PostScript)


Installation Installation


See INSTALL. See INSTALL.


AUTHOR AUTHOR
Patrick Galbraith and Chris Nandor. Last Modified July 12, 2000. Patrick Galbraith and Chris Nandor. Last Modified August 18, 2000.


0 comments on commit 79c0aed

Please sign in to comment.