diff --git a/docs/content/en/Development-API/_index.md b/docs/content/en/Development-API/_index.md index e630cf7f..89eface6 100644 --- a/docs/content/en/Development-API/_index.md +++ b/docs/content/en/Development-API/_index.md @@ -753,9 +753,25 @@ to display. 2022-04-14 17:31:54 [ERROR] This is ERROR message ``` +## 🔍 Function: eask-print (`msg` &rest `args`) + +Standard output printing without newline. + +```elisp +(eask-println "Print to stdout!") +``` + +## 🔍 Function: eask-println (`msg` &rest `args`) + +Like the function `eask-print` but contains the newline at the end. + +```elisp +(eask-println "Print to stdout! (with newline)") +``` + ## 🔍 Function: eask-msg (`msg` &rest `args`) -Like `message` function but will replace unicodes with color. +Like the `message` function but will replace unicode with color. ```elisp (eask-msg "Print this message with newline!") @@ -763,7 +779,7 @@ Like `message` function but will replace unicodes with color. ## 🔍 Function: eask-write (`msg` &rest `args`) -Like `eask-msg` function but without newline at the end. +Like the `eask-msg` function but without the newline at the end. ```elisp (eask-write "Print this message without newline...") diff --git a/docs/content/zh-TW/Development-API/_index.md b/docs/content/zh-TW/Development-API/_index.md index 0fee88da..7de4278c 100644 --- a/docs/content/zh-TW/Development-API/_index.md +++ b/docs/content/zh-TW/Development-API/_index.md @@ -743,6 +743,22 @@ $ cat /.log/messages.log 2022-04-14 17:31:54 [ERROR] 這是錯誤信息 ``` +## 🔍 函式: eask-print (`msg` &rest `args`) + +標準輸出列印不含換行符。 + +```elisp +(eask-println "打印到標準輸出!") +``` + +## 🔍 函式: eask-println (`msg` &rest `args`) + +與函數 `esk-print` 類似,但末尾包含換行符。 + +```elisp +(eask-println "打印到標準輸出! (有換行符)") +``` + ## 🔍 函式: eask-msg (`msg` &rest `args`) 類似於 `message` 函數,但會用顏色替換 unicode。 diff --git a/lisp/_prepare.el b/lisp/_prepare.el index 9b82413c..fdc60d4f 100644 --- a/lisp/_prepare.el +++ b/lisp/_prepare.el @@ -1540,7 +1540,7 @@ character." string)) (defun eask-princ (object &optional stderr) - "Like function `princ'; this is used as the stdin. + "Like function `princ'; with flag STDERR. For argument OBJECT, please see function `princ' for the detials. @@ -1549,28 +1549,27 @@ If optional argument STDERR is non-nil; use stderr instead." (princ object (when stderr #'external-debugging-output)))) (defun eask-print (msg &rest args) - "Like function `eask-princ'; this is used as the stdin. + "Standard output printing without newline. For arguments MSG and ARGS, please see function `eask--format-paint-kwds' for the detials." (eask-princ (apply #'eask--format-paint-kwds msg args))) (defun eask-println (msg &rest args) - "Like function `eask-print' but contains newline at the end; this is also used -as the stdin. + "Like the function `eask-print' but contains the newline at the end. For arguments MSG and ARGS, please see function `eask-print' for the detials." (apply #'eask-print (concat msg "\n") args)) (defun eask-msg (msg &rest args) - "Like function `message' but replace unicodes with color. + "Like the function `message' but replace unicode with color. For arguments MSG and ARGS, please see function `eask--format-paint-kwds' for the detials." (message (apply #'eask--format-paint-kwds msg args))) (defun eask-write (msg &rest args) - "Like function `eask-msg' but without newline at the end. + "Like the function `eask-msg' but without newline at the end. For arguments MSG and ARGS, please see function `eask-msg' for the detials." (eask-princ (apply #'eask--format-paint-kwds msg args) t)) diff --git a/lisp/core/status.el b/lisp/core/status.el index df1b35f3..60304b79 100644 --- a/lisp/core/status.el +++ b/lisp/core/status.el @@ -66,7 +66,6 @@ (eask--print-info `("Eask file" . ,(or eask-file "missing"))) (eask--print-info `("Eask-file Count" . ,(length (eask--find-files default-directory)))) - (eask-println "") ;; XXX: Please increment the number everytime a new information is added! (eask-info "(Total of %s states listed)" (+ 6 5 2)))