From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#12411: 24.2.50; No `make help' target? Date: Wed, 28 Aug 2019 01:56:14 +0200 Message-ID: References: <87har5lyjz.fsf@altern.org> <83sgpujw2j.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="0000000000003eec7b05912205ca" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="127689"; mail-complaints-to="usenet@blaine.gmane.org" Cc: Bastien Guerry , 12411@debbugs.gnu.org, Stefan Monnier To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Aug 28 01:57:11 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1i2lKo-000X6r-TO for geb-bug-gnu-emacs@m.gmane.org; Wed, 28 Aug 2019 01:57:11 +0200 Original-Received: from localhost ([::1]:59776 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i2lKn-0003qB-6Q for geb-bug-gnu-emacs@m.gmane.org; Tue, 27 Aug 2019 19:57:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54330) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i2lKh-0003q5-Gc for bug-gnu-emacs@gnu.org; Tue, 27 Aug 2019 19:57:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i2lKg-0001o3-Fp for bug-gnu-emacs@gnu.org; Tue, 27 Aug 2019 19:57:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:40789) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1i2lKg-0001nw-Cl for bug-gnu-emacs@gnu.org; Tue, 27 Aug 2019 19:57:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1i2lKg-0005Xp-87 for bug-gnu-emacs@gnu.org; Tue, 27 Aug 2019 19:57:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 27 Aug 2019 23:57:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12411 X-GNU-PR-Package: emacs Original-Received: via spool by 12411-submit@debbugs.gnu.org id=B12411.156695019421258 (code B ref 12411); Tue, 27 Aug 2019 23:57:02 +0000 Original-Received: (at 12411) by debbugs.gnu.org; 27 Aug 2019 23:56:34 +0000 Original-Received: from localhost ([127.0.0.1]:49610 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i2lKD-0005Wm-W7 for submit@debbugs.gnu.org; Tue, 27 Aug 2019 19:56:34 -0400 Original-Received: from mail-pg1-f178.google.com ([209.85.215.178]:33945) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i2lKC-0005WX-EB for 12411@debbugs.gnu.org; Tue, 27 Aug 2019 19:56:32 -0400 Original-Received: by mail-pg1-f178.google.com with SMTP id n9so357514pgc.1 for <12411@debbugs.gnu.org>; Tue, 27 Aug 2019 16:56:32 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=NITO+ZClLtf04wtZjRyO/VOWXXoZIAOckYe2o01BR+Y=; b=VsSEKjbJjyHT14pGVcIdO7vL2DDHh6hu2cCSXap+AX5A+9Ot+kJs576nMyN48WldP7 aPOl72S1nUG/A96IVNfQXUb3rdBPaN33y8bqTGt6UxIbiO2m+h1YPXCBPbOZWF29YGwg RDRKEFloNDX2qHsDxww4jz0NPXKIrKTugvkpRmCJ59TJSHkwwOSQFVA4YMNgEZ6nGMmM zaBbS3W30Vy1H15eRkX8KBzGJyICMfKsx67ORu/iwJE6ECkxvnao8JVf7hxUaEWcySFr bwvYZ4XCRoPJu9G04kGtnhZy2j+RH1ZDHMe2+8HPcUvbgbfYQP8JdqRC4MJeqdBB7uQX yCCQ== X-Gm-Message-State: APjAAAW92vLaULEHlVnjqHUljLo0RMHB3mh9PpIemmxog669mrp5ej+6 AjGOrDPrHnq1IebceTd1zrfaNjJ8m/dZNF22wkU= X-Google-Smtp-Source: APXvYqxKzVMOw9z7p10VUtCOrY3ZTSwoJfIM0dZBfMNQpTdGzkwK79LF3+N+IjepBuSDLBVVHa0RKVNlP7GolRarj9A= X-Received: by 2002:aa7:8b46:: with SMTP id i6mr1304456pfd.190.1566950186465; Tue, 27 Aug 2019 16:56:26 -0700 (PDT) In-Reply-To: <83sgpujw2j.fsf@gnu.org> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:165989 Archived-At: --0000000000003eec7b05912205ca Content-Type: text/plain; charset="UTF-8" Eli Zaretskii writes: > > I'm not a Makefile expert, so I couldn't find a way to skip the > > configure step and immediately echo. > > There's GNUmakefile which could be used for that purpose. Thanks. I think I was able to find a good way to do it using that file. > > + @echo "make clean -- delete files from build" > > + @echo "make mostlyclean -- delete most files from build" > > + @echo "make distclean -- delete files from build and configure" > > + @echo "make maintainer-clean -- delete almost everything that can be regenerated" > > It would be good to have these 4 more descriptive. The above > basically just repeats the target names, which is not very helpful. I've extended that. > > + @echo "make bootstrap -- delete all files and force a new bootstrap" > > "Delete all files" sounds scary, and is also incorrect. Fixed. > > + @echo "make uninstall -- delete all installed files" > > I'd say "remove files installed by 'make install'" Done. > > + @echo "make docs -- generate Emacs documentation" > > + @echo "make html -- generate html documentation" > > + @echo "make ps -- generate ps documentation" > > + @echo "make pdf -- generate pdf documentation" > > The description of "make docs" should tell which formats it produces, > otherwise its relation to the 3 other docs-related targets is not > clear. Done. > Thanks. Thanks for reviewing. Please find attached a revised patch, incorporating your changes and also announcing this feature in NEWS for bigger visibility. Best regards, Stefan Kangas --0000000000003eec7b05912205ca Content-Type: application/octet-stream; name="0001-Add-new-make-help-target.patch" Content-Disposition: attachment; filename="0001-Add-new-make-help-target.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_jzuhob3v0 RnJvbSA5MGU5YjYyYzY4OWU2YjYwMWQzYmU4NTMzZWVhNDliOTRkY2NkOTlhIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBXZWQsIDIxIEF1ZyAyMDE5IDAxOjAyOjQzICswMjAwClN1YmplY3Q6IFtQQVRDSF0g QWRkIG5ldyAibWFrZSBoZWxwIiB0YXJnZXQKCiogR05VbWFrZWZpbGU6IEFkZCBuZXcgImhlbHAi IHRhcmdldCB0aGF0IHNob3dzIGEgYnJpZWYgc3VtbWFyeSBvZgpjb21tb24gbWFrZSB0YXJnZXRz LiAgKEJ1ZyMxMjQxMSkKKiBJTlNUQUxMCiogZXRjL05FV1M6IEFubm91bmNlIGl0LgotLS0KIEdO VW1ha2VmaWxlIHwgMzMgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrCiBJTlNUQUxM ICAgICB8ICAzICsrKwogZXRjL05FV1MgICAgfCAgMiArKwogMyBmaWxlcyBjaGFuZ2VkLCAzOCBp bnNlcnRpb25zKCspCgpkaWZmIC0tZ2l0IGEvR05VbWFrZWZpbGUgYi9HTlVtYWtlZmlsZQppbmRl eCBhNjc2MjRlMWY3Li4yNzQxMDljYTQ4IDEwMDY0NAotLS0gYS9HTlVtYWtlZmlsZQorKysgYi9H TlVtYWtlZmlsZQpAQCAtMzIsNiArMzIsMzggQEAKICMgQnV0IHJ1biAnYXV0b2dlbi5zaCcgZmly c3QsIGlmIHRoZSBzb3VyY2Ugd2FzIGNoZWNrZWQgb3V0IGRpcmVjdGx5CiAjIGZyb20gdGhlIHJl cG9zaXRvcnkuCiAKKyMgRGlzcGxheSBoZWxwLgorCitpZmVxIChoZWxwLCQoZmlsdGVyIGhlbHAs JChNQUtFQ01ER09BTFMpKSkKK2hlbHA6CisJQGVjaG8gIk5PVEU6ICBUaGlzIGlzIGEgYnJpZWYg c3VtbWFyeSBvZiBzb21lIGNvbW1vbiBtYWtlIHRhcmdldHMuIgorCUBlY2hvICJGb3IgbW9yZSBk ZXRhaWxlZCBpbmZvcm1hdGlvbiwgcGxlYXNlIHJlYWQgdGhlIGZpbGVzIElOU1RBTEwsIgorCUBl Y2hvICJJTlNUQUxMLlJFUE8sIE1ha2VmaWxlIG9yIHZpc2l0IHRoaXMgVVJMOiIKKwlAZWNobyAi aHR0cDovL3d3dy5nbnUub3JnL3ByZXAvc3RhbmRhcmRzL2h0bWxfbm9kZS9TdGFuZGFyZC1UYXJn ZXRzLmh0bWwiCisJQGVjaG8gIiIKKwlAZWNobyAibWFrZSBhbGwgICAgICAgICAgICAgIC0tIGNv bXBpbGUgYW5kIGJ1aWxkIEVtYWNzIgorCUBlY2hvICJtYWtlIGluc3RhbGwgICAgICAgICAgLS0g aW5zdGFsbCBFbWFjcyIKKwlAZWNobyAibWFrZSBUQUdTICAgICAgICAgICAgIC0tIHVwZGF0ZSB0 YWdzIHRhYmxlcyIKKwlAZWNobyAibWFrZSBjbGVhbiAgICAgICAgICAgIC0tIGRlbGV0ZSBidWls dCBmaWxlcyBidXQgcHJlc2VydmUgY29uZmlndXJhdGlvbiIKKwlAZWNobyAibWFrZSBtb3N0bHlj bGVhbiAgICAgIC0tIGxpa2UgJ21ha2UgY2xlYW4nLCBidXQgbGVhdmUgdGhvc2UgZmlsZXMgdGhh dCIKKwlAZWNobyAiICAgICAgICAgICAgICAgICAgICAgICAgIHVzdWFsbHkgZG8gbm90IG5lZWQg dG8gYmUgcmVjb21waWxlZCIKKwlAZWNobyAibWFrZSBkaXN0Y2xlYW4gICAgICAgIC0tIGRlbGV0 ZSBhbGwgYnVpbGQgYW5kIGNvbmZpZ3VyYXRpb24gZmlsZXMsIgorCUBlY2hvICIgICAgICAgICAg ICAgICAgICAgICAgICAgbGVhdmUgb25seSBmaWxlcyBpbmNsdWRlZCBpbiBzb3VyY2UgZGlzdHJp YnV0aW9uIgorCUBlY2hvICJtYWtlIG1haW50YWluZXItY2xlYW4gLS0gZGVsZXRlIGFsbW9zdCBl dmVyeXRoaW5nIHRoYXQgY2FuIGJlIHJlZ2VuZXJhdGVkIgorCUBlY2hvICJtYWtlIGJvb3RzdHJh cCAgICAgICAgLS0gZGVsZXRlIGFsbCBjb21waWxlZCBmaWxlcyB0byBmb3JjZSBhIG5ldyBib290 c3RyYXAiCisJQGVjaG8gIiAgICAgICAgICAgICAgICAgICAgICAgICBmcm9tIGEgY2xlYW4gc2xh dGUsIHRoZW4gYnVpbGQgaW4gdGhlIG5vcm1hbCB3YXkiCisJQGVjaG8gIm1ha2UgdW5pbnN0YWxs ICAgICAgICAtLSByZW1vdmUgZmlsZXMgaW5zdGFsbGVkIGJ5ICdtYWtlIGluc3RhbGwnIgorCUBl Y2hvICJtYWtlIGNoZWNrICAgICAgICAgICAgLS0gcnVuIHRoZSBFbWFjcyB0ZXN0IHN1aXRlIgor CUBlY2hvICJtYWtlIGRvY3MgICAgICAgICAgICAgLS0gZ2VuZXJhdGUgRW1hY3MgZG9jdW1lbnRh dGlvbiBpbiBpbmZvIGZvcm1hdCIKKwlAZWNobyAibWFrZSBodG1sICAgICAgICAgICAgIC0tIGdl bmVyYXRlIGRvY3VtZW50YXRpb24gaW4gaHRtbCBmb3JtYXQiCisJQGVjaG8gIm1ha2UgcHMgICAg ICAgICAgICAgICAtLSBnZW5lcmF0ZSBkb2N1bWVudGF0aW9uIGluIHBzIGZvcm1hdCIKKwlAZWNo byAibWFrZSBwZGYgICAgICAgICAgICAgIC0tIGdlbmVyYXRlIGRvY3VtZW50YXRpb24gaW4gcGRm IGZvcm1hdCAiCisJQGV4aXQKKworLlBIT05ZOiBoZWxwCisKK2Vsc2UKKwogIyBJZiBhIE1ha2Vm aWxlIGFscmVhZHkgZXhpc3RzLCBqdXN0IHVzZSBpdC4KIAogaWZlcSAoJCh3aWxkY2FyZCBNYWtl ZmlsZSksTWFrZWZpbGUpCkBAIC04MiwzICsxMTQsNCBAQCAuUEhPTlk6CiAKIGVuZGlmCiBlbmRp ZgorZW5kaWYKZGlmZiAtLWdpdCBhL0lOU1RBTEwgYi9JTlNUQUxMCmluZGV4IDY5MzQwMjJjNGUu Ljg2ZjllMDA4MGMgMTAwNjQ0Ci0tLSBhL0lOU1RBTEwKKysrIGIvSU5TVEFMTApAQCAtMTA5LDYg KzEwOSw5IEBAIHNlY3Rpb25zIGlmIHlvdSBuZWVkIHRvLgogICAocHJvdmlkZWQgeW91IGhhdmUg dGhlICdnemlwJyBwcm9ncmFtKSB0aG9zZSBpbnN0YWxsZWQgTGlzcCBzb3VyY2UgKC5lbCkKICAg ZmlsZXMgdGhhdCBoYXZlIGNvcnJlc3BvbmRpbmcgLmVsYyB2ZXJzaW9ucywgYXMgd2VsbCBhcyB0 aGUgSW5mbyBmaWxlcy4KIAorICBZb3UgY2FuIHJlYWQgYSBicmllZiBzdW1tYXJ5IGFib3V0IGNv bW1vbiBtYWtlIHRhcmdldHM6CisKKyAgICAgICAgICAgICAgICBtYWtlIGhlbHAKIAogQURESVRJ T05BTCBESVNUUklCVVRJT04gRklMRVMKIApkaWZmIC0tZ2l0IGEvZXRjL05FV1MgYi9ldGMvTkVX UwppbmRleCBjZjE4NzU5OGNlLi5kZWE0MTNmMWE3IDEwMDY0NAotLS0gYS9ldGMvTkVXUworKysg Yi9ldGMvTkVXUwpAQCAtMTI5LDYgKzEyOSw4IEBAIFRoaXMgaXMgaW50ZW5kZWQgbW9zdGx5IHRv IGhlbHAgZGV2ZWxvcGVycy4KICoqIEVtYWNzIG5vdyByZXF1aXJlcyBHVEsgMi4yNCBhbmQgR1RL IDMuMTAgZm9yIHRoZSBHVEsgMiBhbmQgR1RLIDMKIGJ1aWxkcyByZXNwZWN0aXZlbHkuCiAKKyoq IE5ldyBtYWtlIHRhcmdldCAnaGVscCcgc2hvd3MgYSBzdW1tYXJ5IG9mIGNvbW1vbiBtYWtlIHRh cmdldHMuCisKIAwKICogU3RhcnR1cCBDaGFuZ2VzIGluIEVtYWNzIDI3LjEKIAotLSAKMi4yMy4w Cgo= --0000000000003eec7b05912205ca--