*codecomm.txt*  Code comments preparation helper

OVERVIEW                                              *codecomm-overview*

Sometimes you need to comment some software source code and send it via
email. How do you reference to commit, filepath and exact lines in the
code there? This plugin helps you to do that.

CONFIGURATION                                           *codecomm-config*

The only option for the Vim plugin is the placement of temporary file
with aggregated comments. By default it is /tmp/codecomm.txt. You can
override it in your .vimrc: >
    let g:codecomm_file = "/another/path.txt"

PLUGIN USAGE                                             *codecomm-usage*

* Open necessary commit using Fugitive (:Gedit) and file inside it
* Visually select a bunch of code lines you want to comment
* Press <Leader>cc (usually "\cc") or call :CodeComm command
  specifying the range
* You will see an additional window with your code
* Add necessary comment message below ----- >8 ----- line
* Either press <CR> in normal mode, or save buffer and exit
* Comment window will be closed, saving your consolidated changes
  in temporary file
* To wipe out all your comments either call :CodeCommClear or remove
  that temporary file)

CODECOMM FILE FORMAT                                     *codecomm-format*
>
    -----# 2 [                            ec77b1f6b | src/pyderasn.py ]-----
      79 def tag_encode(num, klass=TagClass.universal, form=TagForm.primitive):
      80     if num < 31:
      81         # [XX|X|.....]
      82         return int2byte(klass.value | form.value | num)
      83     # [XX|X|11111][1.......][1.......] ... [0.......]
      84     return int2byte(klass.value | form.value | 31) + ...
      85
    ---------------------------------- >8 ----------------------------------
    Here goes my comment.

Header line contains:

* Comment's serial number (#2 in example above)
* Optional commit's hash (ec77b1f6b)
* Full path to commented file inside repository

LICENCE                                                *codecomm-license*

Copyright (C) 2017-2019 Sergey Matveev <stargrave@stargrave.org>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3 of the License.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

 vim:filetype=help