documentation

How can I conditionally execute a module-level doctest based on a feature flag?

試著忘記壹切 提交于 2021-02-20 06:40:26
问题 I am writing documentation for a module that has some options controlled by a Cargo feature flag. I'd like to always show this documentation so that consumers of the crate know that it's available, but I need to only run the example when the feature is enabled. lib.rs //! This crate has common utility functions //! //! ``` //! assert_eq!(2, featureful::add_one(1)); //! ``` //! //! You may also want to use the feature flag `solve_halting_problem`: //! //! ``` //! assert!(featureful::is_p_equal

Documentation for Maximo API is unreachable?

谁说我不能喝 提交于 2021-02-20 02:46:34
问题 I am not a 100% sure if this topic is "off-topic" but I couldn't find a more suitable stackexchange for my question. I am working with the Maximo API and use the IBM docs regularly to help me program. 2 days ago I could still reach the docs such as: This gave me a overview of the classes, fields, methods etc. Today I tried reaching the following docs: But the following message shows up: Now, I can't possibly believe they have deleted all docs so I assume they might have moved them but I just

Documentation for Maximo API is unreachable?

青春壹個敷衍的年華 提交于 2021-02-20 02:46:08
问题 I am not a 100% sure if this topic is "off-topic" but I couldn't find a more suitable stackexchange for my question. I am working with the Maximo API and use the IBM docs regularly to help me program. 2 days ago I could still reach the docs such as: This gave me a overview of the classes, fields, methods etc. Today I tried reaching the following docs: But the following message shows up: Now, I can't possibly believe they have deleted all docs so I assume they might have moved them but I just

How to documenting global dependencies for functions?

笑着哭i 提交于 2021-02-19 23:58:26
问题 I've got some C code from a 3rd party vendor (for an embedded platform) that uses global variables (for speed & space optimizations). I'm documenting the code, converting to Doxygen format. How do I put a note in the function documentation that the function requires on global variables and functions? Doxygen has special commands for annotating parameters and return values as describe here: Doxygen Special Commands. I did not see any commands for global variables. Example C code: extern

How to documenting global dependencies for functions?

感情迁移 提交于 2021-02-19 23:51:52
问题 I've got some C code from a 3rd party vendor (for an embedded platform) that uses global variables (for speed & space optimizations). I'm documenting the code, converting to Doxygen format. How do I put a note in the function documentation that the function requires on global variables and functions? Doxygen has special commands for annotating parameters and return values as describe here: Doxygen Special Commands. I did not see any commands for global variables. Example C code: extern

How to documenting global dependencies for functions?

别来无恙 提交于 2021-02-19 23:51:35
问题 I've got some C code from a 3rd party vendor (for an embedded platform) that uses global variables (for speed & space optimizations). I'm documenting the code, converting to Doxygen format. How do I put a note in the function documentation that the function requires on global variables and functions? Doxygen has special commands for annotating parameters and return values as describe here: Doxygen Special Commands. I did not see any commands for global variables. Example C code: extern

How to documenting global dependencies for functions?

半腔热情 提交于 2021-02-19 23:51:05
问题 I've got some C code from a 3rd party vendor (for an embedded platform) that uses global variables (for speed & space optimizations). I'm documenting the code, converting to Doxygen format. How do I put a note in the function documentation that the function requires on global variables and functions? Doxygen has special commands for annotating parameters and return values as describe here: Doxygen Special Commands. I did not see any commands for global variables. Example C code: extern

Sphinx autodoc functions within module

半腔热情 提交于 2021-02-18 12:42:14
问题 I am just getting started with sphinx and willing to learn. I would like to break up my various functions into different sections within my index.rst file. So each function has it's own header. So for example if I have a python file named test.py and within that file I have 2 functions: def foo(): """This prints bar""" print("bar") def bar(): """This prints foo""" print("foo") How could I within the index.rst separate the 2 functions within my test.py file? :mod:`test` -- foo .. automodule::

Use roxygen2 to document multiple datasets in a single documentation object

ぃ、小莉子 提交于 2021-02-17 03:00:55
问题 I'm looking for an equivalent of @describeIn that will allow me to create a single documentation object for multiple R data objects. I had hoped that something like this: #' Tree Distances #' #' These datasets contain the distances between sets #' of 10-tip, 11-tip and 12-tip trees. #' #' @name treeDistances #' @keywords datasets "treeDistances10" "treeDistances11" "treeDistances12" would produce a single manual page that would apply to all three treeDistances## objects, similar to describing

google docs spreadsheet export: How to remove apostrophe from times, dates [closed]

巧了我就是萌 提交于 2021-02-11 15:09:56
问题 Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers. Want to improve this question? Update the question so it's on-topic for Stack Overflow. Closed 3 years ago . Improve this question I'm exporting a spreadsheet from Google Docs as CSV, and there are apostrophe's (') prepended to each date and time value. This is really annoying as OpenOffice doesn't seem to be able to find/replace these in the spreadsheet editor. I could solve the problem by