From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Payas Relekar Newsgroups: gmane.emacs.devel Subject: Re: [ELPA] New package: use-package Date: Sat, 05 Nov 2022 14:15:04 +0530 Message-ID: <87leopdbsw.fsf@gmail.com> References: <87lep4jeeb.fsf@gmail.com> <87v8o52mkn.fsf@gmail.com> <87v8o5w2c1.fsf@posteo.net> <877d0kbkfm.fsf@gmail.com> <875yg4144y.fsf@gmail.com> <87h6zmj451.fsf@gmail.com> <5EE58F68-8B9E-4DE6-BA20-3A88FFDA6528@posteo.net> <871qqkjwjj.fsf@gmail.com> <87o7to2dfy.fsf@gmail.com> <87y1ssugaf.fsf@posteo.net> <875yfw6kbx.fsf@gmail.com> <87r0ykufh8.fsf@posteo.net> <87sfiyl6nb.fsf@posteo.net> <87pme1ddsn.fsf@gmail.com> <871qqhby2k.fsf@posteo.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="20736"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: mu4e 1.8.11; emacs 29.0.50 Cc: Stefan Monnier , emacs-devel To: Philip Kaludercic Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Nov 05 10:29:49 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1orFUp-00059B-QN for ged-emacs-devel@m.gmane-mx.org; Sat, 05 Nov 2022 10:29:47 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1orFU9-0003t1-9P; Sat, 05 Nov 2022 05:29:05 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1orEwA-0004WL-83 for emacs-devel@gnu.org; Sat, 05 Nov 2022 04:53:58 -0400 Original-Received: from mail-pl1-x631.google.com ([2607:f8b0:4864:20::631]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1orEw8-0005yA-MB for emacs-devel@gnu.org; Sat, 05 Nov 2022 04:53:58 -0400 Original-Received: by mail-pl1-x631.google.com with SMTP id b21so6911735plc.9 for ; Sat, 05 Nov 2022 01:53:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:message-id:in-reply-to:date:subject:cc:to:from :user-agent:references:from:to:cc:subject:date:message-id:reply-to; bh=KzFPl/1gMazrmjtl8OtzDJnb+XTL3NtZy0WsyurvWag=; b=ZMi+rtjSyXjn8OnHcSONAicP9wi/BEivO9F3q6a3m0uWZHQxA1QzYB5//axzI0YuYQ N2icEOis7wyAvFwZJxpJFmWQEPsWPQquIf0OaSG6ILHkAPxEcQdlhrxIlnSuA2Ts75/B 2aGMM9GqJPEGS1M/tU9Klk8iGuYNYy3s2WhSHHljSFLNKOVBFqp71ZVn9z2e5O+332BF +j9TOBBkXmjig6o/MgOwx5HldNA1K2GatJ4ZBRyKjQc9xDZVV2CrGs3Q1z1YoVReXknK IRvDU38DF/gD0/AzeXenRqr7jBfBoSnc2/sbf4AodHMyIfUoX3HEaLeyXo0NBxNX1Ef5 2Cnw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=mime-version:message-id:in-reply-to:date:subject:cc:to:from :user-agent:references:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=KzFPl/1gMazrmjtl8OtzDJnb+XTL3NtZy0WsyurvWag=; b=KOVr81eRxj6hCWMV7ieB266uHiz27NZtjgzyCRoa75JAylfY2DxONKsCpWBUYb/0KV clPYMDZeG29nuumqz4e1VpSMMqPBLPVcHlBGuapFjjB2R4UUWHLekDTFlJx7H+H15JVp 9ZcAhZHdO96/1SSfEvpeS9WYi55bULhtmakORskXQ0jdwxvm7EHQxSzFSeMg7CWHlPYM /uiCWL7LioXs/bta7ggeyRgDIx2qtGdOaCx+ACF8I3ZMH6jl2mbjpr6pVDMFzt2qTfxt qWqTihxw0ie6I2x1pADzSGB8gYUSTCpv8fnk4ZXelzxgxEO7uwvCNr57yvcs3WKtP6QM K4Nw== X-Gm-Message-State: ACrzQf0FGKsp01asNggM+o+GoqVKpfT9awrVkd/1/FscVf/6sx474gO5 gWYMAGt4L7iQKKtQX9uelUQ= X-Google-Smtp-Source: AMsMyM54RJBgUxHsenU0tTHZtDaTDi9gAWuMfG3SGkai2QY9yi6qHI0TrNSAXDnxuy/ZQ8GLx9m4kg== X-Received: by 2002:a17:90a:f3d4:b0:213:959f:5a90 with SMTP id ha20-20020a17090af3d400b00213959f5a90mr44669186pjb.54.1667638435222; Sat, 05 Nov 2022 01:53:55 -0700 (PDT) Original-Received: from localhost ([150.107.26.17]) by smtp.gmail.com with ESMTPSA id k5-20020aa79725000000b0056265011136sm862900pfg.112.2022.11.05.01.53.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 05 Nov 2022 01:53:54 -0700 (PDT) In-reply-to: <871qqhby2k.fsf@posteo.net> Received-SPF: pass client-ip=2607:f8b0:4864:20::631; envelope-from=relekarpayas@gmail.com; helo=mail-pl1-x631.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sat, 05 Nov 2022 05:29:02 -0400 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: "Emacs-devel" Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:299178 Archived-At: Philip Kaludercic writes: > Before this is done, I have a few comments on the current manual. In > the section "Installing from an Elpa Archive", goes into how to > configure MELPA/MELPA-Stable. Is this still necessary? It might also > be a good idea to replace ".emacs" with "init.el", as this is the > preferred configuration file AFAIK. I don't know how important this is, > but there are minor typographical issues such as the inconsistent type > setting of "use-package" (sometimes with @code, sometimes without), the > overuse of @code when @var, @key or @kbd would be better or writing "see > @ref" instead of using @xref/@pxref. Installation instructions should indeed point to GNU ELPA, and I will get to fixing that by end of today. I converted the PR to draft to signal it is incomplete for now. > Also, it appears I was mistaken in assuming the manual was finished. > There are still large holes: > > @node Getting Started > @chapter Getting Started > > TODO@. For now, see @code{README.md}. > > @node Debugging Tools > @chapter Debugging Tools > > TODO Philip, since we are targeting just ELPA, do you think this can be worked on after publishing? Merging to mainline is a distant issue, and fixing manual is a future step on that path, as listed before: > 1. Get use-package in ELPA > 2. Complete all documentation > 3. Prepare documentation in texinfo > Will cross that bridge when 2 is done. > 4. Add all relevant files to emacs.git > TBD when 3 is done. > 5. Ensure everything loads properly --