Skip to content
This repository has been archived by the owner on Apr 18, 2020. It is now read-only.
/ __doc__ Public archive

Docstring is a string literal specified in source code that is used, like a comment, to document a specific segment of code

License

Notifications You must be signed in to change notification settings

monolithed/__doc__

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

__doc__ (docstring)

Build Status Dependency Status Code Climate Bitdeli Badge

Docstring is a string literal specified in source code that is used, like a comment, to document a specific segment of code.

A docstring occurs as the first statement in a module, function, class, or method definition.

Languages that support docstrings include Python, Lisp, Elixir, and Clojure.

For more info see the following links:
* [PEP-0257] (http://www.python.org/dev/peps/pep-0257/)
* [Docstring] (http://en.wikipedia.org/wiki/Docstring)
* [Literate programming] (http://en.wikipedia.org/wiki/Literate_programming)

Synopsis

Function.prototype.__doc__

Installation

npm install docstring

Requirements

Object.defineProperty (ECMAScript 5)

Usage

Docstrings can be accessed by the __doc__ property on functions.
The following JavaScript example shows the declaration of docstrings within a source file:

require('docstring');

var test = function (data) {
	/** @params {string} data */
};

console.log(test.__doc__);  // @params {string} data

The docstring have to start with /** or /*!

Preserve directives

/** @preserve */ — [Google Closure Compiler] (https://developers.google.com/closure/compiler/docs/js-for-compiler)
/*! .. */ — [UglifyJS] (http://lisperator.net/uglifyjs/)

This annotation allows important notices (such as legal licenses or copyright text) to survive compilation unchanged. Line breaks are preserved

Testing

npm install
npm test

Inspired by

[PEP-0257] (http://www.python.org/dev/peps/pep-0257/)

Contributing

  • Fork the one
  • Create a topic branch
  • Make the commits
  • Write the tests and run npm test
  • Submit Pull Request once Tests are Passing

About

Docstring is a string literal specified in source code that is used, like a comment, to document a specific segment of code

Resources

License

Stars

Watchers

Forks

Packages

No packages published