[drupal-docs] migration guidelines thinko?

[Gabor Hojtsy]

Plus there is:

| node_save() return value
| node_save() now returns the full node object.

and

| node_save changes
| node_save() now operates with references and does not return anything.

on the very same page. Of which at least one is false, I am sure :)

Goba

Gabor Hojtsy wrote:
> Cheers,
> 
> I have been going through the 4.6->HEAD migration guidelines, fixing up
> some errors in the text, and applying best practices, and found this
> paragraph:
> 
> --------------
> In general you will want to use check_markup($text, $format, TRUE) prior
> to validating or saving the $text and use check_markup($text, $format,
> FALSE) when viewing the $text. In some cases, especially if you are
> using filters which include PHP code, you probably want to call
> check_markup($text, $format, FALSE) in the latter case too.
> --------------
> 
> What is the intended meaning of the last sentence? It does not sound
> right, since it just repeats the previous suggestion, mentioning it as a
> special case.
> 
> Goba