documentation

How to reference an indexer member of a class in C# comments

爱⌒轻易说出口 提交于 2019-11-29 18:09:58
问题 In order to reference a member of a class in XML comments/documentation, you have to use the following tag: <see cref="member"/> It is better explained here. How do you reference an indexer ? I mean, a member like this one: internal object this[ int index ] { ... } Thanks in advance. 回答1: <see cref="P:System.Collections.ArrayList.Item(System.Int32)" /> 回答2: <see cref="this[int]" /> 回答3: In general, in order to find out, how to reference any member in your comments, find the member in your XML

ASP Web API Help pages - Link to class from XML <see> tag

 ̄綄美尐妖づ 提交于 2019-11-29 17:27:27
I'm working on Developing a Web-API project, and i'm very impressed with the auto generated documentation by Microsoft's HelpPages. i enabled custom documentation using the official site creating Help Pages the documentation is generated successfully BUT none of the references to Classes from the <See cref=""> Tag seems to be added to the description, the HelpPages Simply ignores them (that's for a reason). i really wanted to have this feature in my project, i searched a lot (got close sometimes) but none gave a convincing answer. That's why i decided to post my solution to this tweak and

How to get full intellisense tooltip comments working?

自闭症网瘾萝莉.ら 提交于 2019-11-29 15:32:57
问题 I've got some C++/CLI software which is all nice and documented in a C#'ish kind of way which means DOxygen is able to pull it out into some nice html. Is there any way I can get that same information to appear in the intellisense tool tips the way that the .net framework does? For example, lets say this is my header file (MyApp.h): /*************** MyApp.h ***************/ /// My namespace containing all my funky classes namespace MyNamespace { using namespace System; ref class WorldHunger;

Sphinx LaTeX markup limitations

会有一股神秘感。 提交于 2019-11-29 14:52:00
问题 I'm trying to do three really basic things inside of a multi-line math mode in Sphinx (version 1.1.2-1). Write underscores as part of my variable names even in math mode; Use the \big , \biggl , etc., delimiters to make large brackets and parentheses; and include regular text as part of equations. Note the following two things. (1) I am using a raw string in my Python code for the Sphinx-markup documentation, so extra backslashes are not needed for escape characters, and (2) I am not doing

Conditional toctree in Sphinx

我怕爱的太早我们不能终老 提交于 2019-11-29 14:27:16
问题 I want to do multiple versions of a documentation, which differ in the sections that are included. To achieve this I would usually use either the only directive or the ifconfig extension. However, I cannot use any of those in combination with the toctree directive. What I basically want is something like this: .. toctree:: :maxdepth: 2 intro strings datatypes numeric .. only:: university complex Is there a way to do that? 回答1: My previous answer fails if you have hierarchies of table of

Render output from markdown file inside .rst file

血红的双手。 提交于 2019-11-29 14:18:17
I am using Sphinx for documenting a Python project and would like to have content from an existing .md file display inside of a .rst file. ( I have already set up my conf.py to allow for markdown). For example, I have a file called tutorial.md . I also have a .rst file as follows: ml == w2v ^^^ .. automodule:: package.ml.w2v :members: I would like be able to include a link to tutorial.md as follows, such that the content of tutorial.md will display in the file upon rendering. This can be achieved with the following: ml == Tutorial -------- .. include:: ../tutorial.md w2v ^^^ .. automodule::

Howto exclude jpeg-names from regexp replace?

╄→尐↘猪︶ㄣ 提交于 2019-11-29 12:37:00
I'm using a search-function for a documentation site which upon selection of search hit shows page with text highlighted (just as a pdf-reader or netbeans would do). To achive the highlight i use javascript with: function searchHighlight(searchTxt) { var target = $('#page').html(); var re = new RegExp(searchTxt, 'gi'); target = target.replace( re, '<span class="high">' + searchTxt + '</span>' ); $('#page').html(target); } Problem / Question: Since page incudes images with filenames based on md5, some searches messes up the image src. Searching on "1000" will distort the <img src=

R functions' aliases documentation

回眸只為那壹抹淺笑 提交于 2019-11-29 12:10:26
I'm working on R package. I set aliases for some functions this way: foo <- function(){ do_something } foo_alias <- foo I have the documentation for 'foo' function, so when typing: ?foo I get the created documentation. Unfortunately it does not work for foo_alias. When I type: ?foo_alias I get nothing. Is there any solution for that so the alias function inherits the documentation from foo? You should add an alias to your documentation file: \name{foo} \alias{foo} \alias{foo_alias} Or if you use roxygen2 : #' @name foo foo <- function() #' @rdname foo foo_alias <- foo 来源: https://stackoverflow

SandCastle Help File Builder: Search not working

别来无恙 提交于 2019-11-29 11:31:58
I have just downloaded the latest version of Sancastle Help File Builder 2017.1.28.0. According to the answers and comments from this post , I expected the search to work but it doesn't. No matter what I am trying to search for, I will get a "Nothing found" message. BTW, I do not have any aspx file generated. I tried using Google Chrome browser Do I miss any project configuration? How can I make the search working? The described behaviour seems to depend on the used browser. Following snapshots show a working and a NOT working case: I generated a dummy help including some conceptual topics for

How to describe parameters in DRF Docs

早过忘川 提交于 2019-11-29 11:31:48
问题 I'm using Django REST Framework v3.6 built-in interactive documentation django_rest_framework.documentation ( not django-rest-swagger ). Basically, I'm following the official documentation and use this in my URLset configuration: from rest_framework.documentation import include_docs_urls urlpatterns = [ url(r"^", include_docs_urls(title="My API")), ... ] Everything seems to work and I get a nice interactive documentation page, but I have a ViewSet with lookup_field = "slug" and one thing