https://bugs.documentfoundation.org/show_bug.cgi?id=167830
--- Comment #6 from Mike Kaganski <[email protected]> --- (In reply to fpy from comment #5) > almost agree, > for the record, I make a distinction between /mentionning/ and /documenting/. Which makes no sense at all. As usual, nonsensical "disagreement" dilutes the original idea, and prevents useful implementation. The examples are there. They are provided after testing in *some* environment (or that must be so; if not, it's a problem of the one who created the example). This is the final fact; and here, *mentioning* which environment (here: shell flavor) this example works in, is exactly the same as *documenting* this environment. The original comment 0 already used the wording "explicitly mention, which shell that is". There was no mention that we need to differentiate the shown example based on the shell that user uses (even though that is *possible* - in a *different* way, similar to how many API documentations provide a variety of examples, sometimes as "tabbed" box with tabs representing different programming languages; nothing prevents us from providing a similar thing, with tabs for bash/csh/..., and for cmd/powershell/...) - but THAT WAS NOT the topic here, and comment 1 somehow assumed what was not here. Only OS-based differentiation was proposed, with the obvious "use example with the default / most-used / reasonable shell for the OS, and mention that shell". > Q: are the double quotes of this example mandatory ? (on all OSes). Or > optional or replaced by single quotes ? > > ... pdf:draw_pdf_Export:{"PageRange":{"type":"string","value":"2-"}} Which is another off-topic here. Please don't hijack this. If you have a question, ask on Ask LibreOffice. -- You are receiving this mail because: You are the assignee for the bug.
