[PHP-DOC] #31025 [Bgs->Opn]: Unclear summaries between the 4 gz-foo functions

2004-12-10 Thread php at atu dot cjb dot net
 ID:   31025
 User updated by:  php at atu dot cjb dot net
 Reported By:  php at atu dot cjb dot net
-Status:   Bogus
+Status:   Open
 Bug Type: Documentation problem
 Operating System: Irrelevant
 PHP Version:  Irrelevant
 New Comment:

I don't think you noticed what I was talking about.  I am not saying
the documentation for these functions is way off or anything like that.
 All I am saying is that there are two pairs of functions here, and
their summary lines do not match up.

The summaries for gzdeflate and gzinflate are a match: Deflate, then
inflate.

But for gzcompress and gzuncompress the summaries are not a match:
Compress a string, then uncompress a deflated string.

There is no mention of deflating the string in the summary for
gzcompress.  All I am asking for is to make these two pairs of
functions have summaries that match with the other.


Previous Comments:


[2004-12-10 19:45:00] [EMAIL PROTECTED]

The difference is clearly stated in the manual.
gzencode() includes the gzip headers, while gzcompress don't.



[2004-12-08 20:34:03] php at atu dot cjb dot net

Description:

These two make sense:

gzdeflate -- Deflate a string
gzinflate -- Inflate a deflated string

These two do not:

gzcompress -- Compress a string
gzuncompress -- Uncompress a deflated string

I don't know the internal of these functions well enough to say which
way would be correct, but the way it is now is clearly not accurate. 
Both of them say it is acting on a deflated string, however
gzcompress() does not say it creates a deflated string.

Any clarity would be nice.  Thank you.






-- 
Edit this bug report at http://bugs.php.net/?id=31025&edit=1


[PHP-DOC] #31025 [NEW]: Unclear summaries between the 4 gz-foo functions

2004-12-08 Thread php at atu dot cjb dot net
From: php at atu dot cjb dot net
Operating system: Irrelevant
PHP version:  Irrelevant
PHP Bug Type: Documentation problem
Bug description:  Unclear summaries between the 4 gz-foo functions

Description:

These two make sense:

gzdeflate -- Deflate a string
gzinflate -- Inflate a deflated string

These two do not:

gzcompress -- Compress a string
gzuncompress -- Uncompress a deflated string

I don't know the internal of these functions well enough to say which way
would be correct, but the way it is now is clearly not accurate.  Both of
them say it is acting on a deflated string, however gzcompress() does not
say it creates a deflated string.

Any clarity would be nice.  Thank you.


-- 
Edit bug report at http://bugs.php.net/?id=31025&edit=1
-- 
Try a CVS snapshot (php4):   http://bugs.php.net/fix.php?id=31025&r=trysnapshot4
Try a CVS snapshot (php5.0): 
http://bugs.php.net/fix.php?id=31025&r=trysnapshot50
Try a CVS snapshot (php5.1): 
http://bugs.php.net/fix.php?id=31025&r=trysnapshot51
Fixed in CVS:http://bugs.php.net/fix.php?id=31025&r=fixedcvs
Fixed in release:http://bugs.php.net/fix.php?id=31025&r=alreadyfixed
Need backtrace:  http://bugs.php.net/fix.php?id=31025&r=needtrace
Need Reproduce Script:   http://bugs.php.net/fix.php?id=31025&r=needscript
Try newer version:   http://bugs.php.net/fix.php?id=31025&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=31025&r=support
Expected behavior:   http://bugs.php.net/fix.php?id=31025&r=notwrong
Not enough info: 
http://bugs.php.net/fix.php?id=31025&r=notenoughinfo
Submitted twice: 
http://bugs.php.net/fix.php?id=31025&r=submittedtwice
register_globals:http://bugs.php.net/fix.php?id=31025&r=globals
PHP 3 support discontinued:  http://bugs.php.net/fix.php?id=31025&r=php3
Daylight Savings:http://bugs.php.net/fix.php?id=31025&r=dst
IIS Stability:   http://bugs.php.net/fix.php?id=31025&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=31025&r=gnused
Floating point limitations:  http://bugs.php.net/fix.php?id=31025&r=float
MySQL Configuration Error:   http://bugs.php.net/fix.php?id=31025&r=mysqlcfg