[devel] Fw: want to unify documentation

Alexander Bokovoy =?iso-8859-1?q?a=2Ebokovoy_=CE=C1_sam-solutions=2Enet?=
Чт Дек 19 11:34:50 MSK 2002


Может быть кого-нибудь заинтересует? Алексей -- разработчик dictd.

----- Forwarded message from Aleksey Cheusov <cheusov на scnsoft.com> -----

Date: Wed, 18 Dec 2002 21:08:12 +0000 (UTC)
From: Aleksey Cheusov <cheusov на scnsoft.com>
Subject: want to unify documentation
Newsgroups: fido7.ru.linux
Organization: Science Soft


У меня не вопрос.

Я хочу услышать мнение народа по поводу
приведения документации для программистов
в более-менее единую форму.

Имеются ввиду справочники по функциям, классам,
типам и так далее для языков программирования 
и всяким приблудам.

Лично мне надоедает вспоминать, где же это я видел
"в манах ли", в "инфо", во всяких howto, rfc, perldoc
opengroup.org и так далее.

С помощью DICT клиента для emacs dictionary.el
(AFAIK других нет) можно легко всё ето дело привести к одному
виду и настроить на major/minor mode
и получить доступ к любым справочникам
непосредственно там, где программа собственно создаётся
не ползая тормозиллой по всяким opengroup.org и другим.

Вот пример:

(defvar perl-help-history)

(defun lookup-perl-func ()
  (interactive)
  (dictionary-search
    (read-string
	  "word: "
	  (current-word)
	  'perl-help-history)
    "perl_ref"
  )
)
(defun my-perl-mode-hook ()
  (c-set-style "user")
  (local-set-key [f1] 'lookup-perl-func) 
)
(add-hook 'perl-mode-hook      'my-perl-mode-hook)

Вопрос 1: что народ думает по этому поводу.
Вопрос 2: готов ли кто-нибудь из присутствующих
          сконвертировать, например, справочник по stl
          в dict формат или что-то другое, ему нужное.
          Если да, то из этого дела может
          получиться yet another package ;) для любимого
          дистрибутива. Тоже самое касается надстройки
          над dictionary.el.

На вопросах реализации DICT сервера я не останавливаюсь,
потому как это детали.

На мой взгляд, идею полезная и довольно банальна, но,
почему-то, никем не реализована.

Меня интересует ваше мнение.

-- 
Best regards, Aleksey Cheusov.

----- End forwarded message -----

-- 
/ Alexander Bokovoy
---
Remember the good old days, when CPU was singular?



Подробная информация о списке рассылки Devel