From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eric Abrahamsen Newsgroups: gmane.emacs.help Subject: Guidelines for writing Emacs manuals in texinfo? Date: Sun, 06 Aug 2017 09:01:02 -0700 Message-ID: <87o9rs1y9t.fsf@ericabrahamsen.net> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1502035353 32476 195.159.176.226 (6 Aug 2017 16:02:33 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 6 Aug 2017 16:02:33 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sun Aug 06 18:02:29 2017 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1deO0b-0008GQ-LR for geh-help-gnu-emacs@m.gmane.org; Sun, 06 Aug 2017 18:02:29 +0200 Original-Received: from localhost ([::1]:33646 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1deO0h-0001jx-OZ for geh-help-gnu-emacs@m.gmane.org; Sun, 06 Aug 2017 12:02:35 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46824) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1deNzV-0001ZJ-Pe for help-gnu-emacs@gnu.org; Sun, 06 Aug 2017 12:01:22 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1deNzQ-0003kj-WC for help-gnu-emacs@gnu.org; Sun, 06 Aug 2017 12:01:21 -0400 Original-Received: from [195.159.176.226] (port=53883 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1deNzQ-0003k7-Pn for help-gnu-emacs@gnu.org; Sun, 06 Aug 2017 12:01:16 -0400 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1deNzD-0003vX-Sw for help-gnu-emacs@gnu.org; Sun, 06 Aug 2017 18:01:03 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 12 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:BgUmQTEGbavEBTn3l6iAw/HOz3I= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 195.159.176.226 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.org gmane.emacs.help:113947 Archived-At: Hi, Are there guidelines for writing manuals for Emacs' packages in texinfo? Specifically, conventions for which macros to use where, how to format lists of keybindings or user options, all that stuff? I've been looking at the Emacs manual sources, and that's useful, but it would also really be nice to have something laid out explicitly, to help people get off the ground. Thanks, Eric