Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Handle expanded values for run option "--doc" #3701

Closed
tbrowder opened this issue May 18, 2020 · 3 comments
Closed

Handle expanded values for run option "--doc" #3701

tbrowder opened this issue May 18, 2020 · 3 comments
Assignees

Comments

@tbrowder
Copy link
Member

tbrowder commented May 18, 2020

Currently the only way to affect pod leading declarator block text handling is with an environment variable.

It would be much more convenient for the user to select that behavior by adding an extra run option "--doc-fmt=" so one could run Raku something like this:

raku --doc --doc-fmt=preserve ...

or

raku --doc=HTML --doc-fmt=preserve ...
@coke
Copy link
Collaborator

coke commented May 22, 2020

Is it worth abbreviating as "auth-fmt" instead of using "author-format" or perhaps "original" ?

@tbrowder
Copy link
Member Author

tbrowder commented May 22, 2020

@lizmat and @vrurg have already weighed in on the PR I'm working on. The new PR will use a new option with one argument for the current situation. Example use:

$ raku --doc --doc-fmt=preserve ...

where 'preserve' means "keep original text format in declarator blocks."

@vrurg wants to ensure we retain the flexibility to have new uses handled if need be.

@tbrowder
Copy link
Member Author

tbrowder commented Jun 1, 2020

A new PR is the way and will cover most of this discussion.

@tbrowder tbrowder closed this as completed Jun 1, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants