search

h3rald / min

A small but practical concatenative programming language and shell
https://min-lang.org
MIT License
310 stars 23 forks source link

Shell Help Conflict #127

Closed ghost closed 3 years ago

ghost commented 3 years ago 
$ ?cons
=== cons [symbol]
a1 (a*) ==> (a1 a*)

  Prepends a1 to the quotation on top of the stack.
 (
   1
   4
   5
  )

The needless part of symbol documentation is that we see current-stock ( 1 4 5 ) I think this is a bug. People may conflict with current-stock. The stock seems belong to documentation of symbol.

h3rald commented 3 years ago

Yeah, it is not nice.

But at the same time I cannot automatically clear the stack whenever you Issue the help command, so I think I'll just add a === on the last line of the help, as a separator.

ghost commented 3 years ago

Yeah, it is not nice.

But at the same time I cannot automatically clear the stack whenever you Issue the help command, so I think I'll just add a === on the last line of the help, as a separator.

But documentation may include a seperator which is === . Doesn't this make conflict?

h3rald commented 3 years ago

Well, no, there shouldn't be any need to put === at the beginning of the last line, on its own... and even if you do, the description is automatically indented with two spaces so no, there is no conflict...

h3rald commented 3 years ago

Fixed in v0.32.0.