Run an example in a separated byexample
execution
#108
Labels
enhancement
something nice to have but it is not neither critical nor urgent
request for comments
a draft idea that needs more brainstorming, comments are welcome!
Describe the feature you'd like
Sounds weird but there are cases where we want to show how
a bad written example breaks
byexample
and writing theexample in the documentation itself breaks it of course.
Currently the trick is to write the offensive example
in a separated file and run it with
byexample
froma
shell
example.Typically we also do a
cat
to show the content of thefile.
Also, because the file probably has other examples
that we don't want to run, when we do the
cat
we prependthe
~
marker that we remove later with+rm=~
.All of this is quite disruptive.
It would be cool to write the offensive example directly in
the documentation like any other example but marking it
in somehow (with an option perhaps?
-x-fork
?)byexample
should then spawn a fork of itself and run that exampleonly and all the output will be seen as the output of the example
hiding the fact that we ran another
byexample
instance; no needto do a
cat
.The text was updated successfully, but these errors were encountered: