Index: trunk/phase3/includes/Title.php |
— | — | @@ -2271,13 +2271,13 @@ |
2272 | 2272 | } |
2273 | 2273 | |
2274 | 2274 | /** |
2275 | | - * Set the fragment for this title |
2276 | | - * This is kind of bad, since except for this rarely-used function, Title objects |
2277 | | - * are immutable. The reason this is here is because it's better than setting the |
2278 | | - * members directly, which is what Linker::formatComment was doing previously. |
| 2275 | + * Set the fragment for this title. Removes the first character from the |
| 2276 | + * specified fragment before setting, so it assumes you're passing it with |
| 2277 | + * an initial "#". |
2279 | 2278 | * |
| 2279 | + * @deprecated Use Title::makeTitle() with fragment parameter. |
| 2280 | + * |
2280 | 2281 | * @param $fragment \type{\string} text |
2281 | | - * @todo clarify whether access is supposed to be public (was marked as "kind of public") |
2282 | 2282 | */ |
2283 | 2283 | public function setFragment( $fragment ) { |
2284 | 2284 | $this->mFragment = str_replace( '_', ' ', substr( $fragment, 1 ) ); |