Tatsuki SUGIURA
sugi****@users*****
2006年 7月 12日 (水) 20:41:43 JST
Index: slashjp/docs/HOWTO-Plugins.pod diff -u slashjp/docs/HOWTO-Plugins.pod:1.1.1.1 slashjp/docs/HOWTO-Plugins.pod:1.2 --- slashjp/docs/HOWTO-Plugins.pod:1.1.1.1 Wed Jan 28 06:54:05 2004 +++ slashjp/docs/HOWTO-Plugins.pod Wed Jul 12 20:41:42 2006 @@ -104,4 +104,4 @@ =head1 VERSION -$Id: HOWTO-Plugins.pod,v 1.1.1.1 2004/01/27 21:54:05 oliver Exp $ +$Id: HOWTO-Plugins.pod,v 1.2 2006/07/12 11:41:42 sugi Exp $ Index: slashjp/docs/HOWTO-Templates.pod diff -u slashjp/docs/HOWTO-Templates.pod:1.1.1.1 slashjp/docs/HOWTO-Templates.pod:1.2 --- slashjp/docs/HOWTO-Templates.pod:1.1.1.1 Wed Jan 28 06:54:06 2004 +++ slashjp/docs/HOWTO-Templates.pod Wed Jul 12 20:41:42 2006 @@ -109,4 +109,4 @@ =head1 VERSION -$Id: HOWTO-Templates.pod,v 1.1.1.1 2004/01/27 21:54:06 oliver Exp $ +$Id: HOWTO-Templates.pod,v 1.2 2006/07/12 11:41:42 sugi Exp $ Index: slashjp/docs/HOWTO-Themes.pod diff -u slashjp/docs/HOWTO-Themes.pod:1.1.1.1 slashjp/docs/HOWTO-Themes.pod:1.2 --- slashjp/docs/HOWTO-Themes.pod:1.1.1.1 Wed Jan 28 06:54:06 2004 +++ slashjp/docs/HOWTO-Themes.pod Wed Jul 12 20:41:42 2006 @@ -44,4 +44,4 @@ =head1 VERSION -$Id: HOWTO-Themes.pod,v 1.1.1.1 2004/01/27 21:54:06 oliver Exp $ +$Id: HOWTO-Themes.pod,v 1.2 2006/07/12 11:41:42 sugi Exp $ Index: slashjp/docs/INSTALL.html diff -u slashjp/docs/INSTALL.html:1.1.1.1 slashjp/docs/INSTALL.html:1.2 --- slashjp/docs/INSTALL.html:1.1.1.1 Wed Jan 28 06:54:06 2004 +++ slashjp/docs/INSTALL.html Wed Jul 12 20:41:42 2006 @@ -749,7 +749,7 @@ <P> <HR> <H1><A NAME="version">VERSION</A></H1> -<P>$Id: INSTALL.html,v 1.1.1.1 2004/01/27 21:54:06 oliver Exp $</P> +<P>$Id: INSTALL.html,v 1.2 2006/07/12 11:41:42 sugi Exp $</P> </BODY> Index: slashjp/docs/INSTALL.pod diff -u slashjp/docs/INSTALL.pod:1.3 slashjp/docs/INSTALL.pod:1.4 --- slashjp/docs/INSTALL.pod:1.3 Fri Dec 31 21:35:50 2004 +++ slashjp/docs/INSTALL.pod Wed Jul 12 20:41:42 2006 @@ -109,8 +109,9 @@ B<Install MySQL.> -Please refer to MySQL documentation for compilation -and/or installation notes for any questions with this process. +If it is already installed, doublecheck that its version is at least the +minimum required (see L<"REQUIREMENTS">). If you have questions about +the installation process, please refer to MySQL documentation. Slash requires that your MySQL server run in the GMT timezome. Find your global my.cnf file (probably C</etc/my.cnf> or C</etc/mysql/my.cnf>), @@ -119,8 +120,8 @@ timezone = GMT -Start MySQL (it must be running for the installation of Perl modules -and Slash). +Start, or restart, MySQL (it must be running for the installation of +Perl modules and Slash). Create a database to be used by Slash. @@ -135,7 +136,7 @@ B<Install perl.> -perl is likely already installed on your machine; make sure its +perl is likely already installed on your machine; doublecheck that its version is at least the minimum required (see L<"REQUIREMENTS">). @@ -172,13 +173,7 @@ modules are not yet installed. However, some Perl modules will not install without Apache and mod_perl installed. If you wish, come back and run C<make test> after installing here, and then -installing the Perl modules, to make sure everything is OK. Also, -as of January 2002, a C<make test> has thrown spurious errors for -several months because of a persistent minor bug; if you see -"Can't locate object method 'new' via package 'URI::URL'", -read this: - -L<http:E<sol>E<sol>groups.google.comE<sol>groups?threadm=3B82CE4D.8BF0C1D0%40spamless.genwax.com> +installing the Perl modules, to make sure everything is OK. B<NOTE>: If you know what you're doing, Slash will work with a DSO Apache. Be sure you're on the latest versions of Apache and @@ -476,8 +471,8 @@ B<Start it up.> After installation of the site is done, and Apache has been stopped -and started (do NOT try to restart Apache, but do a full stop and -start), run slashd. This should be done via the init script: +and started (do not try to "restart" Apache, but rather do a full stop +and start), then run slashd. This should be done via the init script: /etc/init.d/slash start @@ -628,6 +623,18 @@ entirely before beginning. We are not responsible for any loss of data or functionality.> +=head2 Slash 1.0 -E<gt> Slash 2.2 + +You've got a site running Slash 1.0, from 2001? We're so sorry to +hear that. + +Please read the complete documentation of F<utils/slash1toslash2.2>. +We believe it will convert your database from Slash 1.0 to a new Slash +2.2 database, but it hasn't been tested in some time. The program +documentation (which can be read with F<perldoc>) details exactly what +process it follows to do the conversion, so you can attempt to do it by +hand if you prefer. + =head2 Slash 2.0 -> Slash 2.2 Slash 2.2 is a major upgrade from Slash 2.0. It takes a little bit @@ -866,16 +873,24 @@ =head2 Slash 2.2.6 -E<gt> Slash CVS Use the sql/mysql/upgrades file; see L<"VERSIONS">, "CVS tags", below. - -=head2 Slash 1.0 -E<gt> Slash 2.2 - -Please read the complete documentation of F<utils/slash1toslash2.2>. -It is a program that will convert your database from Slash 1.0 -to a new Slash 2.2 database. The program documentation (which can -be read with F<perldoc>) details exactly what process it follows -to do the conversion, so you can attempt to do it by hand if you -prefer. - +This file is human-readable and very long. You can upgrade a 2.2.6 to +the latest CVS by methodically applying every step in this file, but +it is tedious and requires an engaged human brain reading the comments +(i.e., don't "mysql slash < upgrades", that will fail miserably). + +=head2 Slash CVS -E<gt> later Slash CVS + +Again, use the sql/mysql/upgrades file (and the caveat just mentioned +still applies). Start from the CVS tag you left off at, and proceed +to the CVS tag you upgraded to (which should be the end of the file). +If you're not sure which tag you left off at, you might check the var +'cvs_tag_currentcode', which will contain the right value if you last +updated after September 2005. + +In general, you should stop apache and slashd, do a "make install", +apply the upgrades file a line at a time for each Slash site, run +"template-tool -U -u virtusename" and "symlink-tool -U -u virtusername" +for each Slash site, and then start slashd and apache back up. =head1 REQUIREMENTS @@ -885,44 +900,41 @@ Below, we list the main software components needed. The recommended version is noted, along with the earliest version that has been tested (or is expected) to work. The earliest -versions are not necessarily supported, but should work. -perl 5.6.0 is supported, but MySQL 3.22 is not. - +versions are not recommended or supported, but should work. =over 4 =item perl -Version 5.6.1 (5.6.0). [NOTE: perl 5.6.0 may have some problems. -5.6.1 is recommended.] +Version 5.8.6 (5.6.1). http://www.cpan.org/ -We believe everything works fine with perl 5.8.x, x >= 1, and have -several small Slash installations on it, but we have not tested Unicode -thoroughly, nor have we run Slashdot on it yet. - =item MySQL -Version 4.0.12 (4.0.4). +Version 4.1.18 (4.0.12). http://www.mysql.com/ MySQL 3.23.x is no longer supported, as of CVS tag T_2_5_0_33 -(October 18, 2004). +(October 18, 2004). Slashdot has been running on MySQL 4.1.x +with no problems, so we now recommend that, but 4.0.x works as +well. We have been testing 5.0.x for months but currently, no +production sites run it. =item Apache -Version 1.3.29 (1.3.6). +Version 1.3.33. http://httpd.apache.org/ -B<Do not> use Apache 1.3.28. It has a nasty bug in it that causes -Slash to talk to the web browser as though it is the database server. +Since most of Apache 1.3.x's recent releases included security fixes, +we wouldn't recommend running an earlier version. As far as we know, +Slash is not compatible with Apache 2.x. =item mod_perl -Version 1.29 (1.21). +Version 1.29. http://perl.apache.org/ @@ -1338,4 +1350,4 @@ =head1 VERSION -$Id: INSTALL.pod,v 1.3 2004/12/31 12:35:50 oliver Exp $ +$Id: INSTALL.pod,v 1.4 2006/07/12 11:41:42 sugi Exp $ Index: slashjp/docs/README.html diff -u slashjp/docs/README.html:1.2 slashjp/docs/README.html:1.3 --- slashjp/docs/README.html:1.2 Wed Dec 22 05:54:53 2004 +++ slashjp/docs/README.html Wed Jul 12 20:41:42 2006 @@ -152,9 +152,9 @@ <H1><A NAME="copyright_and_license">COPYRIGHT AND LICENSE</A></H1> <P>The information below applies to everything in this distribution, except where noted.</P> -<P>Copyright 1997-2004 by Open Source Development Network.</P> +<P>Copyright 1997-2005 by Open Source Technology Group.</P> <PRE> - <A HREF="http://www.osdn.com/">http://www.osdn.com/</A></PRE> + <A HREF="http://www.ostg.com/">http://www.ostg.com/</A></PRE> <P>Slash is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 @@ -170,7 +170,7 @@ <P> <HR> <H1><A NAME="version">VERSION</A></H1> -<P>$Id: README.html,v 1.2 2004/12/21 20:54:53 oliver Exp $</P> +<P>$Id: README.html,v 1.3 2006/07/12 11:41:42 sugi Exp $</P> </BODY> Index: slashjp/docs/README.pod diff -u slashjp/docs/README.pod:1.2 slashjp/docs/README.pod:1.3 --- slashjp/docs/README.pod:1.2 Wed Dec 22 05:54:53 2004 +++ slashjp/docs/README.pod Wed Jul 12 20:41:42 2006 @@ -192,9 +192,9 @@ The information below applies to everything in this distribution, except where noted. -Copyright 1997-2004 by Open Source Development Network. +Copyright 1997-2005 by Open Source Technology Group. - http://www.osdn.com/ + http://www.ostg.com/ Slash is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License @@ -215,4 +215,4 @@ =head1 VERSION -$Id: README.pod,v 1.2 2004/12/21 20:54:53 oliver Exp $ +$Id: README.pod,v 1.3 2006/07/12 11:41:42 sugi Exp $ Index: slashjp/docs/sectiontopics.pod diff -u slashjp/docs/sectiontopics.pod:1.1 slashjp/docs/sectiontopics.pod:1.2 --- slashjp/docs/sectiontopics.pod:1.1 Fri Dec 31 21:35:50 2004 +++ slashjp/docs/sectiontopics.pod Wed Jul 12 20:41:42 2006 @@ -263,4 +263,4 @@ =head1 VERSION -$Id: sectiontopics.pod,v 1.1 2004/12/31 12:35:50 oliver Exp $ +$Id: sectiontopics.pod,v 1.2 2006/07/12 11:41:42 sugi Exp $ Index: slashjp/docs/slashguide.pod diff -u slashjp/docs/slashguide.pod:1.2 slashjp/docs/slashguide.pod:1.3 --- slashjp/docs/slashguide.pod:1.2 Fri Dec 31 21:35:50 2004 +++ slashjp/docs/slashguide.pod Wed Jul 12 20:41:42 2006 @@ -445,7 +445,7 @@ Slash::Utility::Anchor, headers and footers and ads -hooks, not really implemented +hooks Slash::Test Slash::Constants slashd and tasks @@ -454,9 +454,9 @@ "task_timespec_foo" vars to override tasks/foo.pl's timespec users the users_* tables, why so many? - the A.C. + the A.C.(s) seclevs - and the coming acl system + ACL (cf. AL2) authors vs. admins vs. regular users stories, story_text they own discussions, and normal form is broken by pulling up disc data into stories table @@ -481,7 +481,7 @@ reconcilation (tasks/run_moderatord.pl) plugins/Messages: the messaging system (pudge: what to say about this?) -accesslist and Slash::Apache::Banlist +AL2 and Slash::Apache::Banlist writing RSS pages: open_backend.pl plugins/HumanConf sections @@ -753,11 +753,15 @@ =head1 CHANGES $Log: slashguide.pod,v $ -Revision 1.2 2004/12/31 12:35:50 oliver -merging upstream changes R_2_3_0_151 -> R_2_5_0_41 +Revision 1.3 2006/07/12 11:41:42 sugi +ovewrite by upstream head -Revision 1.1.1.1 2004/01/27 21:54:09 oliver -Initial Import of Slashcode R_2_3_0_113 +Revision 1.8 2005/08/28 17:30:41 jamiemccarthy +Minor correction notes + +Revision 1.7 2004/10/18 16:56:15 jamiemccarthy +Allow vars to override task timespecs. Don't know why we didn't do +this a couple of years ago, this is simple and will work. Revision 1.6 2003/07/07 22:18:24 jamie Filled in skeleton for themes/plugins, templates, page layout and replication. @@ -787,7 +791,7 @@ =head1 VERSION -$Id: slashguide.pod,v 1.2 2004/12/31 12:35:50 oliver Exp $ +$Id: slashguide.pod,v 1.3 2006/07/12 11:41:42 sugi Exp $ =begin html </div> Index: slashjp/docs/slashstyle.pod diff -u slashjp/docs/slashstyle.pod:1.1.1.1 slashjp/docs/slashstyle.pod:1.2 --- slashjp/docs/slashstyle.pod:1.1.1.1 Wed Jan 28 06:54:11 2004 +++ slashjp/docs/slashstyle.pod Wed Jul 12 20:41:42 2006 @@ -715,8 +715,7 @@ =head2 Indents and Blank Space -All indents should be tabs. Set your tab stops whatever you want them -to be; I use 8 spaces per tabs. +All indents should be tabs. Set your tab stops at 8 spaces per tab. No space before a semicolon that closes a statement. @@ -948,11 +947,12 @@ In general, use single-quotes around literals, and double-quotes when the text needs to be interpolated. -It is OK to omit quotes around names in braces and when using -the => operator, but be careful not to use a name that doubles as -a function; in that case, quote. +It is preferred to omit quotes around names in braces and when +using the => operator. When using a name that a reader might +think is a function, you may want to quote to emphasize it's not. - $what{'time'}{it}{is} = time(); + $what{time}{it}{is} = time(); # OK + $what{'time'}{it}{is} = time(); # also OK When making compound statements, put the primary action first. @@ -1058,8 +1058,12 @@ =head1 CHANGES $Log: slashstyle.pod,v $ - Revision 1.1.1.1 2004/01/27 21:54:11 oliver - Initial Import of Slashcode R_2_3_0_113 + Revision 1.2 2006/07/12 11:41:42 sugi + ovewrite by upstream head + + Revision 1.11 2006/06/01 14:35:35 jamiemccarthy + Make the 8-space tab rule strict; make the unnecessary-quotes-around- + function-names rule lax. Revision 1.10 2003/07/10 16:29:02 pudge Oops, should not use a broken example! @@ -1125,4 +1129,4 @@ =head1 VERSION -$Id: slashstyle.pod,v 1.1.1.1 2004/01/27 21:54:11 oliver Exp $ +$Id: slashstyle.pod,v 1.2 2006/07/12 11:41:42 sugi Exp $ Index: slashjp/docs/slashtables.pod diff -u slashjp/docs/slashtables.pod:1.1.1.1 slashjp/docs/slashtables.pod:1.2 --- slashjp/docs/slashtables.pod:1.1.1.1 Wed Jan 28 06:54:11 2004 +++ slashjp/docs/slashtables.pod Wed Jul 12 20:41:42 2006 @@ -1253,4 +1253,4 @@ =head1 VERSION -$Id: slashtables.pod,v 1.1.1.1 2004/01/27 21:54:11 oliver Exp $ +$Id: slashtables.pod,v 1.2 2006/07/12 11:41:42 sugi Exp $ Index: slashjp/docs/slashtags.pod diff -u slashjp/docs/slashtags.pod:1.1 slashjp/docs/slashtags.pod:1.2 --- slashjp/docs/slashtags.pod:1.1 Wed Dec 22 18:13:41 2004 +++ slashjp/docs/slashtags.pod Wed Jul 12 20:41:42 2006 @@ -305,4 +305,4 @@ =head1 VERSION -$Id: slashtags.pod,v 1.1 2004/12/22 09:13:41 oliver Exp $ +$Id: slashtags.pod,v 1.2 2006/07/12 11:41:42 sugi Exp $
SRAD