From de290eaa23dc9d16296162f0ff52ed00f506e786 Mon Sep 17 00:00:00 2001
From: Sergey Matveev <stargrave@stargrave.org>
Date: Sun, 27 Sep 2020 12:39:38 +0300
Subject: [PATCH] =?utf8?q?=D0=92=D1=8B=D0=BB=D0=BE=D0=B6=D0=B8=D0=BB=20doc?=
 =?utf8?q?stringer.pl?=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

http://git.stargrave.org/cgit.cgi/dotfiles.git/tree/bin/bin/docstringer.pl
ÐÐ»Ñ Ð´Ð¾ÐºÐ¸ C Ð¿ÑÐ¾ÐµÐºÑÐ¾Ð² Ñ ÑÐ¾ÑÑ Ð¸ÑÐ¿Ð¾Ð»ÑÐ·Ð¾Ð²Ð°ÑÑ Texinfo (ÐºÐ°Ðº Ð¸ Ð´Ð»Ñ Ð²ÑÐµÐ³Ð¾). ÐÐ¾
ÑÑÐ°ÑÐ½Ð¾Ð¹ ÐºÐ°ÐºÐ¾Ð¹-ÑÐ¾ Ð¸Ð½ÑÐµÐ³ÑÐ°ÑÐ¸Ð¸, ÐºÐ°Ðº Ñ Sphinx Ñ Python, Ð½ÐµÑÑ. Ð ÑÐ¾ÑÐµÑÑÑ
ÑÑÐ¾Ð±Ñ Ð² C ÐºÐ¾Ð´Ðµ ÑÐ¾Ð¶Ðµ Ð±ÑÐ»Ð° Ð´Ð¾ÐºÑÐ¼ÐµÐ½ÑÐ°ÑÐ¸Ñ ÑÑÐ´Ð¾Ð¼ Ñ Ð½ÑÐ¶Ð½ÑÐ¼Ð¸ ÑÑÐ½ÐºÑÐ¸ÑÐ¼Ð¸,
Ð¿ÐµÑÐµÐ¼ÐµÐ½Ð½ÑÐ¼Ð¸ Ð¸ ÑÐ¸Ð¿Ð°Ð¼Ð¸, Ð² Ð²Ð¸Ð´Ðµ docstring-Ð¾Ð². ÐÐµ Ð¿ÑÐ¾Ð±Ð»ÐµÐ¼Ð°, ÑÐ¶Ðµ Ð´Ð°Ð²Ð½Ð¾
Ð½Ð°Ð¿Ð¸ÑÐ°Ð», Ð½Ð¾ ÑÐ¾Ð»ÑÐºÐ¾ ÑÐµÐ¹ÑÐ°Ñ Ð·Ð°ÐºÐ¾Ð¼Ð¼Ð¸ÑÐ¸Ð», ÑÑÐ¸Ð»Ð¸ÑÑ Ð´Ð»Ñ ÑÑÐ¾Ð³Ð¾ ÑÐ°Ð¼Ð¾Ð¿Ð°Ð»ÑÐ½ÑÑ.

Ð .[ch] ÑÐ°Ð¹Ð»Ð°Ñ ÐµÑÐ»Ð¸ Ð²ÑÑÑÐµÑÐ°ÐµÑÑÑ ÐºÐ¾Ð¼Ð¼ÐµÐ½ÑÐ°ÑÐ¸Ð¹ Ñ TEXINFO: FooBar, ÑÐ¾ Ð´Ð¾ ÐµÐ³Ð¾
ÐºÐ¾Ð½ÑÐ° Ð¾Ð½ Ð±ÑÐ´ÐµÑ ÑÑÐ¸ÑÐ°ÑÑÑÑ ÑÐµÐºÑÑÐ¾Ð¼ FooBar. Ð .texi ÑÐ°Ð¹Ð»Ðµ ÐµÑÐ»Ð¸ Ð±ÑÐ´ÐµÑ
Ð²ÑÑÑÐµÑÐµÐ½ @DOCSTRING FooBar@, ÑÐ¾ ÑÑÐ¾ Ð±ÑÐ´ÐµÑ Ð·Ð°Ð¼ÐµÐ½ÐµÐ½Ð¾ Ð½Ð° ÑÐ¾Ð´ÐµÑÐ¶Ð¸Ð¼Ð¾Ðµ FooBar
ÑÐµÐºÑÑÐ°. ÐÑÐ¾ÑÑÐ¾ Ð¸ ÑÑÑÐµÐºÑÐ¸Ð²Ð½Ð¾. Ð Sphinx Ð¸ÑÐ¿Ð¾Ð»ÑÐ·ÑÑÑÑÑ :py:... ÐºÐ¾Ð½ÑÑÑÑÐºÑÐ¸Ð¸,
Ð° ÑÑÑ Ð¿ÑÐ¾ÑÑÐ¾ DOCSTRING. Ð£ÑÐ¸Ð»Ð¸ÑÐ° ÑÐºÐ°Ð½Ð¸ÑÑÐµÑ Ð¿ÑÐµÐ´Ð¾ÑÑÐ°Ð²Ð»ÐµÐ½Ð½ÑÐ¹ C ÐºÐ¾Ð´,
Ð²ÑÐ¿Ð¸ÑÑÐ¸Ð²Ð°ÐµÑ Ð¸Ð· Ð½ÐµÐ³Ð¾ ÑÐµÐºÑÑ, Ð° Ð´Ð°Ð»ÑÑÐµ Ð¿Ð°ÑÑÐ¸Ñ .texi, ÑÐ¾ÑÑÐ°Ð½ÑÑ ÐµÐ³Ð¾
Ð¾ÑÑÐµÐ½ÐµÐ´ÐµÑÐµÐ½Ð½Ð¾Ðµ Ð¿ÑÐµÐ´ÑÑÐ°Ð²Ð»ÐµÐ½Ð¸Ðµ Ð² Ð¾ÑÐ´ÐµÐ»ÑÐ½Ð¾Ð¹ Ð´Ð¸ÑÐµÐºÑÐ¾ÑÐ¸Ð¸ Ð¸Ð· ÐºÐ¾ÑÐ¾ÑÐ¾Ð¹ ÑÐ¶Ðµ Ð¸
Ð±ÑÐ´ÐµÑ Ð´ÐµÐ»Ð°ÑÑÑÑ Ð´Ð¾ÐºÐ°. ÐÐ¾Ð»Ð³Ð¾Ð´Ð° ÑÑÐ¾ ÑÐ°Ð±Ð¾ÑÐ°ÐµÑ Ð²ÑÑ Ð½Ð° ÑÑÐ°.
-- 
2.48.1