[PHP-DOC] cvs: phpdoc /en/functions ifx.xml
ronabop Sat Feb 24 19:10:23 2001 EDT Modified files: /phpdoc/en/functionsifx.xml Log: Typo in last typo fix. (Need more coffee). Index: phpdoc/en/functions/ifx.xml diff -u phpdoc/en/functions/ifx.xml:1.11 phpdoc/en/functions/ifx.xml:1.12 --- phpdoc/en/functions/ifx.xml:1.11Sat Feb 24 17:49:17 2001 +++ phpdoc/en/functions/ifx.xml Sat Feb 24 19:10:23 2001 @@ -966,7 +966,7 @@ ifx_num_rows -Count the rows already by fetched a query +Count the rows already fetched from a query Description
Re: [PHP-DOC] cvs: phpdoc /en/functions ifx.xml
Jon Parise wrote: > > On Sun, Feb 25, 2001 at 01:49:17AM -, Ron Chmara wrote: > > > -Count the rows already fetched a query > > +Count the rows already by fetched a query > > Perhaps "Count the rows already fetched by a query"? D'Oh! -- --2D426F70|759328624|00101101011001100111 Personal: [EMAIL PROTECTED], 520-326-6109, http://www.opus1.com/ron/ Work: [EMAIL PROTECTED], 520-546-8993, http://www.pnsinc.com/ The opinions expressed in this email are not necessarily those of myself, my employers, or any of the other little voices in my head.
[PHP-DOC] cvs: phpdoc /en/functions strings.xml
ronabop Sat Feb 24 19:05:49 2001 EDT Modified files: /phpdoc/en/functionsstrings.xml Log: Typos. Index: phpdoc/en/functions/strings.xml diff -u phpdoc/en/functions/strings.xml:1.76 phpdoc/en/functions/strings.xml:1.77 --- phpdoc/en/functions/strings.xml:1.76Sat Feb 24 18:38:53 2001 +++ phpdoc/en/functions/strings.xml Sat Feb 24 19:05:49 2001 @@ -247,9 +247,9 @@ - This function returns the given string from one Cyrillic - character set to another. The from and - to arguments are single characters that + This function returns the given string converted from one + Cyrillic character set to another. The from + and to arguments are single characters that represent the source and target Cyrillic character sets. The supported types are: @@ -2137,7 +2137,7 @@ This function tries to return a string with all HTML and PHP - tags stripped from a given str, + tags stripped from a given str. It errors on the side of caution in case of incomplete or bogus tags. It uses the same tag stripping state machine as the fgetss function. @@ -3312,7 +3312,7 @@ - Retuns a string with the first character of + Returns a string with the first character of str capitalized, if that character is alphabetic.
[PHP-DOC] cvs: phpdoc /en/functions strings.xml
ronabop Sat Feb 24 18:38:53 2001 EDT Modified files: /phpdoc/en/functionsstrings.xml Log: Clarifying function returns. Index: phpdoc/en/functions/strings.xml diff -u phpdoc/en/functions/strings.xml:1.75 phpdoc/en/functions/strings.xml:1.76 --- phpdoc/en/functions/strings.xml:1.75Fri Feb 23 07:35:46 2001 +++ phpdoc/en/functions/strings.xml Sat Feb 24 18:38:53 2001 @@ -247,7 +247,7 @@ - This function converts the given string from one Cyrillic + This function returns the given string from one Cyrillic character set to another. The from and to arguments are single characters that represent the source and target Cyrillic character sets. The @@ -394,7 +394,7 @@ - crypt will encrypt a string using the + crypt will return an encrypted string using the standard Unix DES encryption method. Arguments are a string to be encrypted and an optional two-character salt string to base the encryption on. See the Unix man page for your @@ -952,7 +952,7 @@ Description - int levenshtein + int levenshtein string str1 string str2 @@ -972,10 +972,10 @@ -This function returns the Levenshtein-Distance between the + This function returns the Levenshtein-Distance between the two argument strings or -1, if one of the argument strings is longer than the limit of 255 characters (255 should be -more than enough for name or dictionary comparison, and + more than enough for name or dictionary comparison, and nobody serious would be doing genetic analysis with PHP). @@ -1266,8 +1266,8 @@ - This function strips whitespace from the start of a string and - returns the stripped string. The whitespace + This function returns a string with whitespace stripped from the + beginning of str. The whitespace characters it currently strips are: "\n", "\r", "\t", "\v", "\0", and a plain space. @@ -1294,7 +1294,7 @@ Calculates the MD5 hash of str using the RSA Data Security, Inc. - MD5 Message-Digest Algorithm. + MD5 Message-Digest Algorithm, and returns that hash. See also: crc32 @@ -1476,8 +1476,8 @@ See also: print, sprintf, -sscanf, fscanf, -and flush. + sscanf, fscanf, + and flush. @@ -2136,8 +2136,9 @@ - This function tries to strip all HTML and PHP tags from the given - string. It errors on the side of caution in case of incomplete + This function tries to return a string with all HTML and PHP + tags stripped from a given str, + It errors on the side of caution in case of incomplete or bogus tags. It uses the same tag stripping state machine as the fgetss function. @@ -2453,9 +2454,9 @@ - This functions pads the input string on - the left, the right, or both sides to the specifed padding - length. If the optional argument + This functions returns the input string + padded on the left, the right, or both sides to the specifed + padding length. If the optional argument pad_string is not supplied, the input is padded with spaces, otherwise it is padded with characters from pad_string @@ -2944,7 +2945,7 @@ str_replace - Replace all occurrences of the search string in subject with the replacement string + Replace all occurrences of the search string with the replacement string @@ -2958,19 +2959,20 @@ - This function replaces all occurences of search in - subject with the given - replace value. If you don't need fancy replacing - rules, you should always use this function instead of - ereg_replace or - preg_replace. + This function returns a string or an array with all occurences of + search in subject + replaced with the given replace value. If + you don't need fancy replacing rules, you should always use this + function instead of ereg_replace or + preg_replace. + In PHP 4.0.5 and later, every parameter to str_replace can be an array. If subject is an array, then the search and replace - is performed on every entry of subject, and the + is performed with every entry of subject, and the return value is an array as well. @@ -3024,10 +3026,10 @@ - This function operates on str, translating - all occurrences of each character in from - to the corresponding character in to and - returning the result. + This function returns a copy of str, + translating all occurrences of each character in + from to the correspon
Re: [PHP-DOC] cvs: phpdoc /en/functions ifx.xml
On Sun, Feb 25, 2001 at 01:49:17AM -, Ron Chmara wrote: > -Count the rows already fetched a query > +Count the rows already by fetched a query Perhaps "Count the rows already fetched by a query"? -- Jon Parise ([EMAIL PROTECTED]) . Rochester Inst. of Technology http://www.csh.rit.edu/~jon/ : Computer Science House Member
[PHP-DOC] cvs: phpdoc /en/functions ifx.xml
ronabop Sat Feb 24 17:49:17 2001 EDT Modified files: /phpdoc/en/functionsifx.xml Log: Typo. Index: phpdoc/en/functions/ifx.xml diff -u phpdoc/en/functions/ifx.xml:1.10 phpdoc/en/functions/ifx.xml:1.11 --- phpdoc/en/functions/ifx.xml:1.10Sat Sep 30 13:33:57 2000 +++ phpdoc/en/functions/ifx.xml Sat Feb 24 17:49:17 2001 @@ -966,7 +966,7 @@ ifx_num_rows -Count the rows already fetched a query +Count the rows already by fetched a query Description
[PHP-DOC] cvs: phpdoc /en/functions url.xml
ronabop Sat Feb 24 17:34:59 2001 EDT
Modified files:
/phpdoc/en/functionsurl.xml
Log:
Fixing reference to $querystring, de-tabbing (minor XML cleanups).
Index: phpdoc/en/functions/url.xml
diff -u phpdoc/en/functions/url.xml:1.9 phpdoc/en/functions/url.xml:1.10
--- phpdoc/en/functions/url.xml:1.9 Wed Sep 6 11:04:53 2000
+++ phpdoc/en/functions/url.xml Sat Feb 24 17:34:59 2001
@@ -102,8 +102,8 @@
See also rawurlencode,
- urldecode,
- urlencode.
+ urldecode,
+ urlencode.
@@ -148,8 +148,8 @@
See also rawurldecode,
- urldecode,
- urlencode.
+ urldecode,
+ urlencode.
@@ -173,7 +173,7 @@
Urldecode example
-$a = split ('&', $querystring);
+$a = split ('&', $QUERY_STRING);
$i = 0;
while ($i < count ($a)) {
$b = split ('=', $a [$i]);
@@ -186,8 +186,8 @@
See also urlencode,
- rawurlencode,
-
rawurldecode.
+ function>rawurlencode,
+ rawurldecode.
@@ -225,29 +225,32 @@
- Note: Be careful about variables that may match HTML entities.
- Things like &, © and £ are parsed by the browser
- and the actual entity is used instead of the desired variable name. This
- is an obvious hassle that the W3C has been telling people about for years.
- The reference is here: &url.argsep;
- PHP supports changing the argument separator to the W3C-suggested
- semi-colon through the arg_separator .ini directive. Unfortunately most
- user agents do not send form data in this semi-colon separated format.
- A more portable way around this is to use & instead of & as the
-separator. You don't need to change PHP's arg_separator for this. Leave
- it as &, but simply encode your URLs using
htmlentities(urlencode($data)).
+
+Note: Be careful about variables that may match HTML entities.
+Things like &, © and £ are parsed by the
+browser and the actual entity is used instead of the desired
+variable name. This is an obvious hassle that the W3C has been
+telling people about for years. The reference is here:
+&url.argsep; PHP supports
+changing the argument separator to the W3C-suggested semi-colon
+through the arg_separator .ini directive. Unfortunately most user
+agents do not send form data in this semi-colon separated format.
+A more portable way around this is to use & instead of
+& as the separator. You don't need to change PHP's
+arg_separator for this. Leave it as &, but simply encode
+your URLs using htmlentities(urlencode($data)).
Urlencode/htmlentities example
echo '';
-
+
See also urldecode,
- htmlentities,
- rawurldecode,
-
rawurlencode.
+ htmlentities,
+ rawurldecode,
+ rawurlencode.
[PHP-DOC] cvs: phpdoc /en/functions pgsql.xml
ronabop Sat Feb 24 17:20:18 2001 EDT
Modified files:
/phpdoc/en/functionspgsql.xml
Log:
Fixing order of arguments as per errata notes.
Index: phpdoc/en/functions/pgsql.xml
diff -u phpdoc/en/functions/pgsql.xml:1.29 phpdoc/en/functions/pgsql.xml:1.30
--- phpdoc/en/functions/pgsql.xml:1.29 Tue Dec 12 20:51:27 2000
+++ phpdoc/en/functions/pgsql.xml Sat Feb 24 17:20:18 2001
@@ -66,7 +66,7 @@
One can establish a connection with the following value pairs
set in the command string:
$conn = pg_Connect("host=myHost port=myPort tty=myTTY
-options=myOptions user=myUser password=myPassword dbname=myDB");
+options=myOptions dbname=myDB user=myUser password=myPassword ");
@@ -188,15 +188,15 @@
//connect to a database named "mary"
$dbconn2 = pg_Connect ("host=localhost port=5432 dbname=mary");
//connect to a database named "mary" on "localhost" at port "5432"
-$dbconn3 = pg_Connect ("user=lamb password=b dbname=mary ");
-//connect to a database named "mary" with a username and password
+$dbconn3 = pg_Connect ("host=sheep port=5432 dbname=mary user=lamb password=b");
+//connect to a database named "mary" on the host "sheep" with a username and password
?>
- The arguments available include dbname
- port, host,
- tty, options,
- user, and password
+ The arguments available include host,
+ port, tty,
+ options, dbname,
+ user, and password.
This function returns a connection index that is needed by other
@@ -1079,10 +1079,10 @@
Returns a connection index on success, or false if the connection
could not be made. Opens a connection to a PostgreSQL database.
The arguments should be within a quoted string.
- The arguments available include dbname
- port, host,
- tty, options,
- user, and password
+ The arguments available include host,
+ port, tty,
+ options, dbname,
+ user, and password.
This function returns a connection index that is needed by other
[PHP-DOC] cvs: phpdoc /ja/functions dir.xml mnogosearch.xml pcre.xml strings.xml /ja/language oop.xml
hirokawaSat Feb 24 17:00:03 2001 EDT Modified files: /phpdoc/ja/functionsdir.xml mnogosearch.xml pcre.xml strings.xml /phpdoc/ja/language oop.xml Log: update translation. Index: phpdoc/ja/functions/dir.xml diff -u phpdoc/ja/functions/dir.xml:1.5 phpdoc/ja/functions/dir.xml:1.6 --- phpdoc/ja/functions/dir.xml:1.5 Sun Feb 18 15:29:44 2001 +++ phpdoc/ja/functions/dir.xml Sat Feb 24 17:00:01 2001 @@ -150,7 +150,31 @@ ディレクトリ・ハンドルをオープンします。この関数は、この後、 closedir, readdir, rewinddir 関数コールで使用されます。 - + + + path +が有効なディレクトリでないかまたは権 + +限が制限されているかファイルシステムのエラーによりディレクトリが + オープンできない場合、opendir は false を返 + +し、PHPエラーを生成します。opendirのこのエラー + 出力は、関数名の前に `@' +を付けることにより抑制できます。 + + + + opendir の例 + + + + + Index: phpdoc/ja/functions/mnogosearch.xml diff -u phpdoc/ja/functions/mnogosearch.xml:1.3 phpdoc/ja/functions/mnogosearch.xml:1.4 --- phpdoc/ja/functions/mnogosearch.xml:1.3 Wed Feb 21 15:20:37 2001 +++ phpdoc/ja/functions/mnogosearch.xml Sat Feb 24 17:00:02 2001 @@ -14,6 +14,23 @@ --with-mnogosearch=DIRのようにそ のパスを指定する必要があります。 + + +mnoGoSearchは、イントラネットおよびインターネットサーバ用の多機能 + +な検索エンジンソフトウエアであり、GNUライセンスのもとで配布されて + +います。mnoGoSearchは、サイト内の検索から料理レシピまたは新聞検索、 + +ftpアーカイブ検索、新聞記事検索といった特定の検索システムといった + +広い範囲のアプリケーションを構築する等といったユニークないくつかの + +機能を有しています。mnoGoSearchによりHTML、PDF、テキストドキュメン + +トに関する全文テキストインデックス作成と検索が可能になります。 +mnoGoSearch +は二つの部分から構成されます。最初の部分は、インデック +ス機構(indexer)です。indexerは、HTTP, FTP, NEWS +サーバまたはローカ + +ルファイルにアクセスし、再帰的に全てのドキュメントを取得して、その + +ドキュメントに関するメタデータを優れた効率的な手法でSQLデータベー + +スに保存します。各ドキュメントがその対応するURLで参照された後、 + +indexerにより収集されたメタデータが後で検索処理において使用されま +す。検索は、Webインターフェースにより行われます。C +CGI、PHP、Perl +用の検索フロントエンドが含まれています。 + PHPには、MySQLとの接続ライブラリが組み込まれており、MySQLにアクセ @@ -146,6 +163,7 @@ UDM_PARAM_SEARCH_MODE - 検索モード。次の値が利用可能です。: UDM_MODE_ALL - 全ての単語を検索します。; UDM_MODE_ANY - 全ての単語で検索する; + UDM_MODE_PHRASE - 熟語検索; UDM_MODE_BOOL - 論理値検索。論理値検索に関する詳細については udm_find を参照下さい。 @@ -172,9 +190,29 @@ す。 利用可能な値: UDM_TRACK_ENABLED, UDM_TRACK_DISABLED. - + + UDM_PARAM_PHRASE_MODE - +熟語を用いたインデックスデータベースか + どうかを定義します。(indexer.confにおける"phrase" +パラメータ) + 使用可能な値: UDM_PHRASE_ENABLED および UDM_PHRASE_DISABLED。 + 熟語検索が有効な場合(UDM_PHRASE_ENABLED)でも、全てのモード + +(ANY、ALL、BOOL、PHRASE)で検索が可能であることに注意して下さい。 + +mnoGoSearchのバージョン3.1.10で熟語検索がSQLと組み込みデータベー + +スモードでのみサポートされました。一方、3.1.11で熟語がcachemode + でもサポートされ始めました。 + + + 熟語検索の例: + + + "Arizona desert" - このクエリは、"Arizona desert"を熟語として含 + +む全てのドキュメントを返します。熟語の前後に二重引用符が必要で + あることに注意して下さい。 + + + + UDM_PARAM_CHARSET - ローカルなcharsetを定義します。利用可能な値: mnoGoSearchによりサポートされるcharsetの組, 例えば、koi8-r, cp1251, ... @@ -268,7 +306,26 @@ UDM_MATCH_END - 単語の終りにマッチ UDM_MATCH_WORD - 単語全体にマッチ UDM_MATCH_SUBSTR - 単語の部分文字列にマッチ - + + + + UDM_PARAM_MIN_WORD_LEN - 単語の最短長を定義します。 + +この制限より短い単語は、stopwordとみなされます。このパラメータ + +はその値自身も範囲に含むことに注意して下さい。つまり、 + UDM_PARAM_MIN_WORD_LEN=3 の場合、3文字の長さの単語はstopwordと + +見なされませんが、2文字の単語はstopwordとみなされます。デフォル + トは1です。 + + + + + UDM_PARAM_MAX_WORD_LEN - +最長の単語を定義します。この制限よりも + +長い単符は、stopwordとみなされます。このパラメータはその値も範 + +囲に含むことに注意して下さい。つまり、UDM_PARAM_MAX_WORD_LEN=32 + +の場合、32文字の単語はstopwordとみなされませんが、33文字の単語 + はみなされます。デフォルトは、32です。 + + Index: phpdoc/ja/functions/pcre.xml diff -u phpdoc/ja/functions/pcre.xml:1.16 phpdoc/ja/functions/pcre.xml:1.17 --- phpdoc/ja/functions/pcre.xml:1.16 Tue Feb 20 07:12:19 2001 +++ phpdoc/ja/functions/pcre.xmlSat Feb 24 17:00:02 2001 @@ -339,8 +339,9 @@ を得るために左括弧は(1から始まって)左から右に番号がふられます。 - subjectにおいてマッチしなかった場合、 - 変更されずに返されます。 + +マッチした場合、新しいsubjectが返されます。 + マッチしなかった場合には、subject +は、無変 + 更で返されます。 preg_replaceに渡す全てのパラメータは配列とする Index: phpdoc/ja/functions/strings.xml diff -u phpdoc/ja/functions/strings.xml:1.26 phpdoc/ja/functions/strings.xml:1.27 --- phpdoc/ja/functions/strings.xml:1.26Sat Feb 3 17:05:22 2001 +++ phpdoc/ja/functions/strings.xml Sat Feb 24 17:00:02 2001 @@ -1372,7 +1372,7 @@ nl2br -改行文字を HTML の改行指定文字に変換する + +改行文字の前にHTMLの改行指定文字を挿入する 説明 @@ -1384,7 +1384,7 @@ stringに含まれるすべての改行文字の - 前に '
' を挿入して返します。 + 前に '
' を挿入して返します。 htmlspecialchars、 Index: phpdoc/ja/language/oop.xml diff -u phpdoc/ja/language/oop.xml:1.5 phpdoc/ja/language/oop.xml:1.6 -
[PHP-DOC] cvs: phpdoc /en/language control-structures.xml
ronabop Sat Feb 24 16:57:11 2001 EDT
Modified files:
/phpdoc/en/language control-structures.xml
Log:
Note that default belongs last, per errata.
Index: phpdoc/en/language/control-structures.xml
diff -u phpdoc/en/language/control-structures.xml:1.23
phpdoc/en/language/control-structures.xml:1.24
--- phpdoc/en/language/control-structures.xml:1.23 Sun Oct 29 07:58:09 2000
+++ phpdoc/en/language/control-structures.xml Sat Feb 24 16:57:11 2001
@@ -733,7 +733,8 @@
A special case is the default case. This case matches anything
-that wasn't matched by the other cases. For example:
+that wasn't matched by the other cases, and should be the last
+case statement. For example:
switch ($i) {
Re: [PHP-DOC] Still locked?
At 05:20 PM 2/24/01 -0700, Ron Chmara wrote: >[16:16:57] waiting for nobody's lock in /repository/phpdoc/en/chapters > >It's now been a week or three I've cleared the lock. -Andrei
[PHP-DOC] cvs: phpdoc /en/chapters install.xml
ronabop Sat Feb 24 16:21:28 2001 EDT Modified files: /phpdoc/en/chapters install.xml Log: Changing section titles for clearer section navigation. Index: phpdoc/en/chapters/install.xml diff -u phpdoc/en/chapters/install.xml:1.41 phpdoc/en/chapters/install.xml:1.42 --- phpdoc/en/chapters/install.xml:1.41 Wed Jan 31 04:19:13 2001 +++ phpdoc/en/chapters/install.xml Sat Feb 24 16:21:28 2001 @@ -150,7 +150,7 @@ - Linux installs + Unix/Linux installs This section contains notes and hints specific to installing PHP on Linux distributions. @@ -171,7 +171,7 @@ - HP-UX installs + Unix/HP-UX installs This section contains notes and hints specific to installing PHP on HP-UX systems. @@ -254,7 +254,7 @@ - Solaris installs + Unix/Solaris installs This section contains notes and hints specific to installing PHP on Solaris systems. @@ -331,7 +331,7 @@ - Mac OS X installs + Unix/Mac OS X installs This section contains notes and hints specific to installing PHP on Mac OS X. @@ -3233,7 +3233,7 @@ - Apache Server installs + Servers-Apache This section contains notes and hints specific to Apache installs of PHP, both for Unix and @@ -3464,7 +3464,7 @@ - CGI/Commandline Server Installs + Servers-CGI/Commandline The default is to build PHP as a CGI program. This creates a commandline interpreter, which can be used for CGI processing, or @@ -3510,7 +3510,7 @@ - fhttpd Server Installs + Servers-fhttpd To build PHP as an fhttpd module, answer "yes" to "Build as an fhttpd module?" (the - Caudium Server installs + Servers-Caudium PHP 4 can be build as a Pike module for the Caudium webserver. Note that this is not supported with PHP 3. Follow the simple @@ -3574,7 +3574,7 @@ - IIS/PWS Server installs + Servers-IIS/PWS This section contains notes and hints specific to IIS (Microsoft Internet Information Server) installing PHP for @@ -3880,7 +3880,7 @@ - Netscape and iPlanet Enterprise Server Installs + Servers-Netscape and iPlanet To build PHP with NES or iPlanet web servers, enter the proper install directory for the @@ -4007,7 +4007,7 @@ - OmniHTTPd Server installs + Servers-OmniHTTPd Server This section contains notes and hints specific to OmniHTTPd. @@ -4077,7 +4077,7 @@ - Oreilly Website Pro Server installs + Servers-Oreilly Website Pro This section contains notes and hints specific to Oreilly Website Pro. @@ -4121,7 +4121,7 @@ - Xitami Server installs + Servers-Xitami This section contains notes and hints specific to Xitami. @@ -4167,7 +4167,7 @@ - Other web servers + Servers-Other web servers PHP can be built to support a large number of web servers. Please see Server-related
[PHP-DOC] Still locked?
[16:16:57] waiting for nobody's lock in /repository/phpdoc/en/chapters It's now been a week or three -ronabop --2D426F70|759328624|00101101011001100111 Personal: [EMAIL PROTECTED], 520-326-6109, http://www.opus1.com/ron/ Work: [EMAIL PROTECTED], 520-546-8993, http://www.pnsinc.com/ The opinions expressed in this email are not necessarily those of myself, my employers, or any of the other little voices in my head.
Re: [PHP-DOC] Off-topic: adding the printed PHP manuals to books.php
Rasmus Lerdorf wrote: > > Since the PHP manual is under the GPL all people around the world think, > > they can copy it and publish it in printed form. This is also the thinking > > mostly all PHP Group and Documentation members. But the publisher have > > now the copyright and this can us protect from distributing the manual as > > usual. Copyright law is not GPL. > The publisher cannot possibly have the copyright. They can. The GPL doesn't cover printed, non code, documentation. It merely requires that the source for *programs* is freely included with any derivative programs. The copyright itself on the manual covers most of the base work, but it doesn't protect it from intellectual property piracy and theft in the same way the GPL protects the code from IP piracy and theft. It's deep and murky in the realm of "original authorship" vs. "derivative works", but basically, it works like this: Even though the actual documentation, examples, descriptions, and prototypes for the PHP code is owned by the documentation group... the copyrights for "Core PHP Programming" (Atkinson, Prentice Hall) are owned by Atkinson and Prentice Hall... in spite of that work having much which is derived _from_ the actual documentation. Since it's a derivative work, but _not_ under the GPL (GPL doesn't apply to docs), Prentice Hall can claim authorship and copyright (rightfully so, in that case...). While it would be an interesting case of splitting hairs on what is, and isn't, "original" vs. "derivative" work, suffice to say that with a few lines of Perl, anybody can "take over" the copyrights by making a manual with some minor content changes. They can then sue somebody else if they published a manual, because the PHP group *doesn't* have the copyright on their printed manual, or derivative works, and any manual published by the PHP group would be far too similar to the one that is *already owned* by somebody else. Lets take another example: I've authored text on many manual pages. I own some copyright on those documents. Somebody downloads manual, and changes my variable names, my program flow, my whitespace, and prints the pages. Now _they_ own copyright on that derivative, printed document. I try to sell a printed version of my writing. They can sue me, and win, because I don't have a printed, "prior art", work that I can point to and say "I wrote it first"!. Now, I could print out every page I work on, copyright it, and _then_ I'd own it (and have prior art), but they are still within their bounds to download the entire thing, print it out, make changes, and own the derivative portions (without suing me) but then, each author is saddled with the burden of protecting their authorship. > The authors of the > documentation hold the copyright. I see nothing wrong with them printing > up the documentation. If there were to try to stop others from doing the > same, then we would have a problem. Exactly the issue! This is the problem to head off before it happens. "Retroactively protecting" it *doesn't work*. If it became a problem, declaring that "it wasn't intended to happen this way" isn't a legal argument. If we protect it from IP piracy _now_, we stop others from ever having the ability to enforce a sole copyright. > But until I see evidence of that I don't see the issue. I view this issue in terms of protecting the intellectual property from future piracy. If we can do a few things to prevent it from being taken away, ever, then we can stop all of these discussions and be done with the issue. If we don't do something, the documentation is available for theft, and we have no recourse if somebody starts trying to sue us. I suggest that we can fix the whole problem by changing one line on the copyright page: http://www.php.net/manual/en/copyright.php "This manual can be redistributed under the terms of the GNU Free Documentation License as published by the Free Software Foundation". This would require derivatives to print a URL to the original docs, if they are printing more than 100 copies (not a burdensome request). It allows them to make substantial changes. It preserves original authorship, as well as protecting the rights of derivative authorship. It _is_ a "viral" license in that sense, as you cannot take two derivations away from the "source" and claim sole ownership. -Ronabop PS: http://www.php.net/COPYRIGHT.txt 1998(?) --2D426F70|759328624|00101101011001100111 Personal: [EMAIL PROTECTED], 520-326-6109, http://www.opus1.com/ron/ Work: [EMAIL PROTECTED], 520-546-8993, http://www.pnsinc.com/ The opinions expressed in this email are not necessarily those of myself, my employers, or any of the other little voices in my head.
[PHP-DOC] cvs: phpdoc /de/functions posix.xml
samesch Sat Feb 24 15:44:05 2001 EDT Modified files: /phpdoc/de/functionsposix.xml Log: again, little more tranlated Index: phpdoc/de/functions/posix.xml diff -u phpdoc/de/functions/posix.xml:1.7 phpdoc/de/functions/posix.xml:1.8 --- phpdoc/de/functions/posix.xml:1.7 Sat Feb 24 02:00:20 2001 +++ phpdoc/de/functions/posix.xml Sat Feb 24 15:44:04 2001 @@ -527,14 +527,15 @@ - Needs to be written. + Muss noch geschrieben werden. + posix_ttyname -Determine terminal device name +Ermittelt den Namen des Terminal-Devices Beschreibung @@ -545,7 +546,8 @@ - Needs to be written. + Muss noch geschrieben werden. + @@ -553,7 +555,7 @@ posix_isatty - Determine if a file descriptor is an interactive terminal + Ermittelt, ob ein Datei-Deskriptor ein interaktives Terminal ist @@ -565,14 +567,15 @@ - Needs to be written. + Muss noch geschrieben werden. + posix_getcwd -Pathname of current directory +Pfadname des aktuellen Verzeichnisses Beschreibung @@ -583,7 +586,8 @@ - Needs to be written ASAP. + Sollte ASAP geschrieben werden. + @@ -591,7 +595,7 @@ posix_mkfifo - Create a fifo special file (a named pipe) + Erzeugt eine "FIFO special"-Datei (named pipe) @@ -599,37 +603,43 @@ bool posix_getcwd - string pathname - int mode + string Pfadname + int Modus - Needs to be written ASAP.. + Sollte ASAP geschrieben werden. + posix_getgrnam -Return info about a group by name + + Liefert zu einem Gruppennamen Informationen über diese Gruppe + Beschreibung array posix_getgrnam - string name + string Gruppenname - Needs to be written. + Muss noch geschrieben werden. + posix_getgrgid -Return info about a group by group id + + Liefert zu einer Gruppen-ID Informationen über diese Gruppe + Beschreibung @@ -640,32 +650,37 @@ - Needs to be written. + Muss noch geschrieben werden. + posix_getpwnam -Return info about a user by username + + Liefert zu einem Benutzernamen Informationen über diese + Benutzerin + Beschreibung array posix_getpwnam - string username + string Benutzername - Returns an associative array containing information about a - user referenced by an alphanumeric username, passed in the - username parameter. + Diese Funktion gibt ein assoziatives Array zurück, das + Informationen über die Benutzerin enthält, auf die der in + Benutzername übergebene alphanumerische + Benutzername verweist. - The array elements returned are: + Die Elemente des zurückgegebenen Array sind: - The user information array + Das Benutzerinformation-Array @@ -676,59 +691,67 @@ name + + Das name-Element enthält den Benutzernamen. Es handelt sich + dabei nicht um ihren wirklichen, kompletten Namen, sondern + um einen kurzen "Bezeichner" der Benutzerin mit + normalerweise weniger als 16 Zeichen. Der Benutzername + sollte der selbe wie der bei Aufruf der Funktion verwendete + Parameter Benutzername sein und ist + von daher redundant. + - The name element contains the username of the user. This is - a short, usually less than 16 character "handle" of the user, - not her real, full name. This should be the same as the - username parameter used when calling the - function, and hence redundant. passwd - The passwd element contains the user's password in an encrypted - format. Often, for example on a system employing "shadow" - passwords, an asterisk is returned instead. + Das passwd-Element enthält das verschlüsselte Passwort der + Benutzerin. Oft, zum Beispiel wenn auf einem System + "shadow"-Passwörter verwendet werden, wird stattdessen ein + Sternchen zurückgegeben. uid - User ID of the user in numeric form. + Die Benutzer-ID in numerischem Format. gid - The group ID of the user. Use the function - posix_getgrgid to resolve the - group name and a list of its members. + Die Gruppen-ID der Be
[PHP-DOC] cvs: phpdoc /kr/functions http.xml
noribsd Sat Feb 24 14:09:34 2001 EDT
Modified files:
/phpdoc/kr/functionshttp.xml
Log:
modified some sentences
Index: phpdoc/kr/functions/http.xml
diff -u phpdoc/kr/functions/http.xml:1.5 phpdoc/kr/functions/http.xml:1.6
--- phpdoc/kr/functions/http.xml:1.5Sat Feb 24 14:03:54 2001
+++ phpdoc/kr/functions/http.xmlSat Feb 24 14:09:34 2001
@@ -28,7 +28,7 @@
헤더와 관련된 두가지 특별한 경우가 있다.
첫번째로 "Location" 헤더에 대해 설명하겠다. 이것은
지정된 헤더내용을 브라우저에
전송하면서 동시에 아파치 서버로 REDIRECT
코드(REDIRECT status code)를 돌려준다. 스크립트 작성자의 관점으로
볼때 이것은 별로
-중요한 것이 아니지만 아파치 내부동작에
관심이 있는 사람들은 알아두어야 할 것이다.
+중요한 내용이 아니지만 아파치
+내부동작에 관심이 있는 사람들에겐 알아두어야 할 내용이다.
+
header ("Location: http://www.php.net"); /* PHP
웹사이트로
[PHP-DOC] cvs: phpdoc /kr/functions http.xml
noribsd Sat Feb 24 14:03:54 2001 EDT
Modified files:
/phpdoc/kr/functionshttp.xml
Log:
modified words spacing and tags spacing look more clear
Index: phpdoc/kr/functions/http.xml
diff -u phpdoc/kr/functions/http.xml:1.4 phpdoc/kr/functions/http.xml:1.5
--- phpdoc/kr/functions/http.xml:1.4Fri Feb 23 21:27:13 2001
+++ phpdoc/kr/functions/http.xmlSat Feb 24 14:03:54 2001
@@ -1,189 +1,245 @@
-
- HTTP functions
- HTTP
-
-
- 여기 설명되어질 함수들은 원격브라우저에 보내질
각종 출력들을HTTP 프로토콜에 충실히 기반하여 다룰 수 있게
해준다.
-
-
-
-
-
-header
-HTTP 헤더를 전송한다.
-
-
-함수 설명
-
-
- int header
- string string
-
-
- Header 함수는 HTML 파일
상단에 HTTP 헤더 문자열을 전송한다. HTTP 헤더에
대한 자세한 정보는 HTTP 1.1
Specification 를 참조하기 바란다.
-
- 헤더와 관련된 두가지 특별한 경우가 있다. 첫번째로
"Location " 헤더에 대해 설명하겠다. 이것은 지정된
헤더내용을 브라우저에 전송하면서 동시에 아파치 서버로
REDIRECT 코드(REDIRECT status code)를 돌려준다. 스크립트 작성자의
관점으로 볼때 이것은 별로 중요한 것이 아니지만 아파치
내부동작에 관심이 있는 사람들은 알아두어야 할 것이다.
-
-header ("Location: http://www.php.net"); /* PHP 웹사이트로
-리다이렉트한다. */
-exit; /* 리다이렉트되고 있을때 아래에 있는
- 코드가 실행되지 않도록 한다 */
-
-
-
- 두번째는 "HTTP/" 문자열로 시작하는 헤더를 사용하는
경우이다. (대소문자는 상관없음) 예를 들어, 아파치의
ErrorDocument 404 지시자가 여러분의 PHP 스크립트를 가리키게
해두었다면 그 스크립트가 실제로 404 코드를 생성하고
있는지 확실히 해두는 것이 좋다. 아래의 예를 참조하라.
-
-header ("HTTP/1.0 404 Not Found");
-
-
-
- PHP 스크립트를 사용하다보면 클라이언트 브라우저와
프록시서버에 캐쉬되지 말아야할 출력(예: 다이내믹 HTML)을
만들어야 할 경우가 있다. 이럴 경우 아래와 같이
클라이언트와 프록시서버의 캐쉬기능을 강제로 해제할 수 있다.
-
-header ("Expires: Mon, 26 Jul 1997 05:00:00 GMT");// Date in the past
-header ("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
- // always modified
-header ("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1
-header ("Pragma: no-cache"); // HTTP/1.0
-
-
-
- header 함수는 HTML의 공백라인이나
PHP가 만들어낸 어떠한 출력보다도 가장 먼저 호출되어야
한다. header 함수가 호출되기 전에
include 와 require 혹은 기타 다른
파일엑세스 관련 함수를 사용하거나 코드내에 공백을 넣는
경우는 스크립트 작성자가 흔히 저지르는 실수이다. 설령
PHP/HTML 파일 하나만 사용한다고 해도 이같은 실수의 가능성은
여전히 존재한다.
-
-
-
-
-
-
-// 윗줄에 공백이 있으므로 제대로 동작하지 않을 것이다.
-
-
-
-
- headers_sent도 참고하라.
-
-
-
-
-
-
-headers_sent
-헤더가 전송되었으면 참(true)을 돌려준다.
-
-
-함수 설명
-
-
- boolean headers_sent
- void
-
-
-
- 이 함수는 HTTP 헤더가 이미 전송되어진 경우 참(true)을,
반대의 경우 거짓(false)을 돌려준다.
-
- header도 참고하라.
-
-
-
-
-
-
-setcookie
-쿠키를 설정한다.
-
-
-Description
-
-
- int setcookie
- string name
- string
- value
-
- int
- expire
-
- string
- path
-
- string
- domain
-
- int
- secure
-
-
-
- Setcookie 함수는 쿠키를 설정하기 위해
쓰인다. 쿠키는 다른 어떠한 헤더보다도
먼저 전송되어야 한다. (이것은 PHP와는
상관없는 쿠키 자체의 제약이다) 즉, 이 함수를 쓰기 위해서
는 이나 내부에
오는 어떠한 태그들 보다 먼저 호출되어야 하는 것이다.
- name 을 제외한 모든 인수들은
선택적으로 주어질 수 있다. (만약 name인수만
주어진 경우 그 이름을 가진 쿠키는 모두 삭제될 것이다).
또한 주어지지 않은 인수를 빈 문자열
("") 로 대체할 수 있다.
expire 와 secure 인수는 정수값
이며, 주어지지 않을 경우 빈 문자열로 대체될 수 없는 대신 숫자
0 으로 대체할 수 있다. expire 인수는 표준
유닉스 시간으로 time 이나
mktime 함수가 돌려보내는 정수값을 쓸 수
있다. secure 인수가 지정된 쿠키는 안전한 HTTPS
접속에서만 전송이 허용된다.
-
- 주의해야할 사항:
-
-
-
-쿠키는 그 쿠키를 유효하게 하기 위해 페이지를
재로딩하기 전까지는 작동되지 않는다.
-
-
-
-쿠키는 생성될 당시의 인수(parameter)를 그대로 넣어
삭제해야 한다.
-
-
-
- PHP3는 setcookie 함수가 하나의
스크립트 안에서 여러번 호출된 경우 그 호출된 역순으로
처리를 한다. 이 경우 새로운 쿠키를 하나 추가하기 전에
기존의 쿠키를 하나 삭제하려면 추가하는 구문이 삭제하는
구문보다 먼저 놓여야 원하는 결과를 얻을 수 있다. 반대로 PHP4는
여러번 호출된 setcookie 함수들을 호출된 순서
그대로 처리한다.
-
-
- 아래는 쿠키를 전송하는 예제이다:
- Setcookie send examples
-
-setcookie ("TestCookie", "Test Value");
-setcookie ("TestCookie", $value,time()+3600); /* expire in 1 hour */
-setcookie ("TestCookie", $value,time()+3600, "/~rasmus/", ".utoronto.ca", 1);
-
-
-
-
- 아래는 위의 예제에서 전송한 쿠키를 삭제하는 예제이다:
-
- setcookie delete examples
-
-setcookie ("TestCookie");
-// 만료시기를 한시간 전으로 설정
-setcookie ("TestCookie", "", time() - 3600);
-setcookie ("TestCookie", "", time() - 3600, "/~rasmus/", ".utoronto.ca", 1);
-
-
-쿠키를 삭제하려면 인수로 주어질 만료시기가 만료시점을
기준으로 과거를 가리키고 있는지 확인해야 한다.
-
- 쿠키의 일부분은 필요한 경우 자동적으로
url인코딩(urlencoded)이 된후 전송이 되며, 그것을 다시 받을
경우에도 자동적인 디코딩 및 쿠키 이름에 해당하는
변
[PHP-DOC] cvs: phpdoc /nl Translators /nl/functions dl.xml
derick Sat Feb 24 05:59:34 2001 EDT Modified files: /phpdoc/nl Translators /phpdoc/nl/functionsdl.xml Log: - Finished dl.xml Index: phpdoc/nl/Translators diff -u phpdoc/nl/Translators:1.16 phpdoc/nl/Translators:1.17 --- phpdoc/nl/Translators:1.16 Fri Feb 16 07:56:35 2001 +++ phpdoc/nl/Translators Sat Feb 24 05:59:34 2001 @@ -56,7 +56,7 @@ dbase.xml dbm.xml dir.xml Derick done -dl.xml +dl.xml Derick done domxml.xml exec.xml fdf.xml @@ -107,7 +107,7 @@ url.xml Derick started var.xml vmailmgr.xml -wddx.xml +wddx.xmlDerick started xml.xml yaz.xml zlib.xml Index: phpdoc/nl/functions/dl.xml diff -u phpdoc/nl/functions/dl.xml:1.1 phpdoc/nl/functions/dl.xml:1.2 --- phpdoc/nl/functions/dl.xml:1.1 Tue Oct 10 15:07:53 2000 +++ phpdoc/nl/functions/dl.xml Sat Feb 24 05:59:34 2001 @@ -1,14 +1,14 @@ - Dynamic Loading functions - Dyn.loading + Dynamische laad functies + Dynamisch laden dl -load a PHP extension at runtime +laad runtime een PHP extensie -Description +Omschrijving int dl @@ -16,10 +16,10 @@ - Loads the PHP extension defined in - library. See also the extension_dir configuration - directive. + Laad de PHP extensie aangegeven met + library. Zie ook de extension_dir configuratie + optie.
[PHP-DOC] cvs: phpdoc /de/functions posix.xml
samesch Sat Feb 24 02:00:20 2001 EDT Modified files: /phpdoc/de/functionsposix.xml Log: little more tranlated Index: phpdoc/de/functions/posix.xml diff -u phpdoc/de/functions/posix.xml:1.6 phpdoc/de/functions/posix.xml:1.7 --- phpdoc/de/functions/posix.xml:1.6 Fri Feb 23 13:08:30 2001 +++ phpdoc/de/functions/posix.xml Sat Feb 24 02:00:20 2001 @@ -102,9 +102,12 @@ Diese Funktion gibt die numerische wirkliche Benutzer-ID des - aktuellen Prozesses zurück. Für Informationen, wie die - Benutzer-ID in einen gebräuchlichen Benutzernamen umgewandelt - werden kann, siehe auch posix_getpwuid. + aktuellen Prozesses zurück. + + + Für Informationen darüber, wie die Benutzer-ID in einen + gebräuchlichen Benutzernamen umgewandelt werden kann, siehe auch + posix_getpwuid. @@ -126,9 +129,12 @@ Diese Funktion gibt die numerische effektive Benutzer-ID des - aktuellen Prozesses zurück. Für Informationen, wie die - Benutzer-ID in einen gebräuchlichen Benutzernamen umgewandelt - werden kann, siehe auch posix_getpwuid. + aktuellen Prozesses zurück. + + + Für Informationen darüber, wie die Benutzer-ID in einen + gebräuchlichen Benutzernamen umgewandelt werden kann, siehe auch + posix_getpwuid. @@ -150,10 +156,13 @@ Diese Funktion gibt die numerische wirkliche Gruppen-ID des - aktuellen Prozesses zurück. Für Informationen, wie die Gruppen-ID - in einen gebräuchlichen Gruppennamen umgewandelt werden kann, - siehe auch posix_getgrgid. + aktuellen Prozesses zurück. + + Für Informationen darüber, wie die Gruppen-ID in einen + gebräuchlichen Gruppennamen umgewandelt werden kann, siehe auch + posix_getgrgid. + @@ -177,8 +186,8 @@ aktuellen Prozesses zurück. - Für Informationen, wie die Gruppen-ID in einen gebräuchlichen - Gruppennamen umgewandelt werden kann, siehe auch + Für Informationen darüber, wie die Gruppen-ID in einen + gebräuchlichen Gruppennamen umgewandelt werden kann, siehe auch posix_getgrgid. @@ -235,7 +244,10 @@ gid des aktuellen Prozesses. Es handelt sich um eine privilegierte Funktion, für die Sie die entspechenden Berechtigungen (normalerweise root) auf Ihrem - System benötigen, um diese Funktion ausführen zu können. + System benötigen, um diese Funktion ausführen zu können. Die + sachgemäße Reihenfolge der Funktionsaufrufe ist zuerst + posix_setgid und zuletzt + posix_setuid. Gibt bei Erfolg TRUE und andernfalls FALSE zurück. @@ -243,15 +255,6 @@ Siehe auch: posix_setuid. - - Set the real group ID of the current process. This is a - privileged function and you need appropriate privileges (usually - root) on your system to be able to perform this function. The - appropriate order of function calls is - posix_setgid first, - posix_setuid last. - - Returns TRUE on success, FALSE otherwise. @@ -259,7 +262,7 @@ posix_getgroups - Return the group set of the current process + Liefert die Gruppenliste des aktuellen Prozesses @@ -270,18 +273,25 @@ void + + Diese Funktion gibt ein Array von ganzen Zahlen zurück, das die + numerischen Gruppen-IDs der Gruppenliste des aktuellen Prozesses + enthält. + - Returns an array of integers containing the numeric group ids of - the group set of the current process. See also - posix_getgrgid for information on how to - convert this into useable group names. + Für Informationen darüber, wie die Gruppen-IDs in gebräuchliche + Gruppennamen umgewandelt werden können, siehe auch + posix_getgrgid. + posix_getlogin -Return login name + + Liefert den Benutzernamen des Eigentümers des aktuellen Prozesses + Beschreibung @@ -292,9 +302,14 @@ - Returns the login name of the user owning the current process. - See posix_getpwnam for information how to - get more information about this user. + Diese Funktion gibt den Benutzernamen des Benutzers zurück, dem + der aktuelle Prozess gehört. + + + Für Informationen darüber, wie mehr Informationen über diesen + Benutzer bekommen werden können, siehe + posix_getpwnam. +
