@@ -460,9 +460,12 @@ pub mod builtin {
460460 /// With [`column!`] and [`file!`], these macros provide debugging information for
461461 /// developers about the location within the source.
462462 ///
463- /// The expanded expression has type `u32`, and the returned line is not
464- /// the invocation of the `line!()` macro itself, but rather the first macro
465- /// invocation leading up to the invocation of the `line!()` macro.
463+ /// The expanded expression has type `u32` and is 1-based, so the first line
464+ /// in each file evaluates to 1, the second to 2, etc. This is consistent
465+ /// with error messages by common compilers or popular editors.
466+ /// The returned line is not the invocation of the `line!` macro itself,
467+ /// but rather the first macro invocation leading up to the invocation
468+ /// of the `line!` macro.
466469 ///
467470 /// [`column!`]: macro.column.html
468471 /// [`file!`]: macro.file.html
@@ -482,9 +485,12 @@ pub mod builtin {
482485 /// With [`line!`] and [`file!`], these macros provide debugging information for
483486 /// developers about the location within the source.
484487 ///
485- /// The expanded expression has type `u32`, and the returned column is not
486- /// the invocation of the `column!` macro itself, but rather the first macro
487- /// invocation leading up to the invocation of the `column!` macro.
488+ /// The expanded expression has type `u32` and is 1-based, so the first column
489+ /// in each line evaluates to 1, the second to 2, etc. This is consistent
490+ /// with error messages by common compilers or popular editors.
491+ /// The returned column is not the invocation of the `column!` macro itself,
492+ /// but rather the first macro invocation leading up to the invocation
493+ /// of the `column!` macro.
488494 ///
489495 /// [`line!`]: macro.line.html
490496 /// [`file!`]: macro.file.html
0 commit comments