Um, hello?

I wasn't trying to turn this into a general bitch session 
on the manual, and I really don't think that's appropriate.
Worse, it obscures and devalues the value of the bug report.

I'm just trying to draw attention to a possible software
malfunction in the "commentary" section of the online docs.

If you are a tech writer or other employee with mysql.com, please skip
the following bracketed paragraphs, they're for others:

[[
Please, if you wish to argue about the use of "WHERE" or
case-sensitive searches, do it on some other Subject line, okay?

The focus here is specifically on the COMMENTS in the ON-LINE
DOCUMENTATION of MYSQL.  Those COMMENTS are usually
totally irrelevant to the topic being discussed, which makes them USELESS.
]]

I will offer an example:
Looking for commentary and useful tips on INSERT...SELECT syntax:
http://www.mysql.com/doc/I/N/INSERT_SELECT.html

What I find begins thus:


yval : Note that the input to INET_NTOA, and the output from INET_ATON are in 
host byte order. 

Michael Babcock <[EMAIL PROTECTED]>: As opposed to "left.id = 
right.id", a LEFT join means that all of the left table's IDs are displayed, 
and only those rows in the right table with the same IDs are joined in. Vice 
versa for a RIGHT join.

Ari Ukkonen <[EMAIL PROTECTED]>: I think Boolean or logical type is badly 
needed in Mysql. You can use an Enum and IS NOT NULL/IS NULL in your 
statements to simulate this to test for the existence or absence of NULL 
values but this is not an elegant solution. 

Daniel Scherly <[EMAIL PROTECTED]>: Example how to use the 
DATE_FORMAT function to reformat a DATETIME (YYYY-MM-DD hh:mm:ss) column and 
output the newly formated date with PHP:

.
.
.
etc., etc.   All valuable and appropriate comments, no doubt.  FOR SOME OTHER 
PART OF THE MANUAL.  I hope some tech writer at Mysql AB is reading this.

Steve Rapaport

---------------------------------------------------------------------
Before posting, please check:
   http://www.mysql.com/manual.php   (the manual)
   http://lists.mysql.com/           (the list archive)

To request this thread, e-mail <[EMAIL PROTECTED]>
To unsubscribe, e-mail <[EMAIL PROTECTED]>
Trouble unsubscribing? Try: http://lists.mysql.com/php/unsubscribe.php

Reply via email to