@@ -20,17 +20,18 @@ macro_rules! syscall {
2020 } ;
2121}
2222
23- /// Macro version of `syscall1`
23+ /// Macro version of `syscall1`.
2424#[ macro_export]
2525macro_rules! syscall1 {
2626 ( $nr: ident, $a1: expr) => {
2727 $crate:: syscall1( $crate:: nr:: $nr, $a1 as usize )
2828 } ;
2929}
3030
31- /// Macro for printing to the HOST standard output
31+ /// Macro for printing to the HOST standard output.
3232///
33- /// This macro returns a `Result<(), ()>` value
33+ /// This is similar to the `print!` macro in the standard library. Both will panic on any failure to
34+ /// print.
3435#[ macro_export]
3536macro_rules! hprint {
3637 ( $s: expr) => {
@@ -43,7 +44,8 @@ macro_rules! hprint {
4344
4445/// Macro for printing to the HOST standard output, with a newline.
4546///
46- /// This macro returns a `Result<(), ()>` value
47+ /// This is similar to the `println!` macro in the standard library. Both will panic on any failure to
48+ /// print.
4749#[ macro_export]
4850macro_rules! hprintln {
4951 ( ) => {
@@ -57,9 +59,10 @@ macro_rules! hprintln {
5759 } ;
5860}
5961
60- /// Macro for printing to the HOST standard error
62+ /// Macro for printing to the HOST standard error.
6163///
62- /// This macro returns a `Result<(), ()>` value
64+ /// This is similar to the `eprint!` macro in the standard library. Both will panic on any failure
65+ /// to print.
6366#[ macro_export]
6467macro_rules! heprint {
6568 ( $s: expr) => {
@@ -72,7 +75,8 @@ macro_rules! heprint {
7275
7376/// Macro for printing to the HOST standard error, with a newline.
7477///
75- /// This macro returns a `Result<(), ()>` value
78+ /// This is similar to the `eprintln!` macro in the standard library. Both will panic on any failure
79+ /// to print.
7680#[ macro_export]
7781macro_rules! heprintln {
7882 ( ) => {
@@ -86,22 +90,23 @@ macro_rules! heprintln {
8690 } ;
8791}
8892
89- /// Macro that prints and returns the value of a given expression
90- /// for quick and dirty debugging. Works exactly like `dbg!` in
91- /// the standard library, replacing `eprintln` with `heprintln`,
92- /// which it unwraps.
93+ /// Macro that prints and returns the value of a given expression for quick and
94+ /// dirty debugging.
95+ ///
96+ /// Works exactly like `dbg!` in the standard library, replacing `eprintln!`
97+ /// with `heprintln!`.
9398#[ macro_export]
9499macro_rules! dbg {
95100 ( ) => {
96- $crate:: heprintln!( "[{}:{}]" , file!( ) , line!( ) ) . unwrap ( ) ;
101+ $crate:: heprintln!( "[{}:{}]" , file!( ) , line!( ) ) ;
97102 } ;
98103 ( $val: expr) => {
99104 // Use of `match` here is intentional because it affects the lifetimes
100105 // of temporaries - https://stackoverflow.com/a/48732525/1063961
101106 match $val {
102107 tmp => {
103108 $crate:: heprintln!( "[{}:{}] {} = {:#?}" ,
104- file!( ) , line!( ) , stringify!( $val) , & tmp) . unwrap ( ) ;
109+ file!( ) , line!( ) , stringify!( $val) , & tmp) ;
105110 tmp
106111 }
107112 }
0 commit comments