Ответ

Misha v.3 22.09.2011 17:00 / 22.09.2011 17:02

в PHP location -- специальный случай:

The second special case is the "Location:" header. Not only does it send this header back to the browser, but it also returns a REDIRECT (302) status code to the browser unless the 201 or a 3xx status code has already been set.

т.е. это у них location делает не просто отправку "raw HTTP header", как это написано в описании функции, а дополнительно выставляет ещё один HTTP header status.
это исключение -- оно должно быть описано.

у нас этого исключения нет (да, возможно с ним удобнее, но сейчас обсуждается не это), но раз так, то отдельно описывать нечего: установка всех заголовков подчиняется одной логике.

если вы считаете, что это стоит описать -- залогиньтесь да добавьте комментарий к этому разделу документации для потомков, делов-то.

---