From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: File names in ChangeLog entries Date: Wed, 1 Dec 2021 15:14:05 -0800 Message-ID: References: <831r2xt32t.fsf@gnu.org> <83ilw8sa9j.fsf@gnu.org> <835ys8s1gg.fsf@gnu.org> <87czmgruyc.fsf@gnuvola.org> <83h7bsqfxh.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="522"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Eli Zaretskii , Thien-Thi Nguyen , emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Dec 02 00:15:13 2021 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 1msYoj-000ARa-Hd for ged-emacs-devel@m.gmane-mx.org; Thu, 02 Dec 2021 00:15:13 +0100 Original-Received: from localhost ([::1]:54154 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1msYoh-0007RF-O7 for ged-emacs-devel@m.gmane-mx.org; Wed, 01 Dec 2021 18:15:11 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:35700) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1msYnj-0006js-8S for emacs-devel@gnu.org; Wed, 01 Dec 2021 18:14:15 -0500 Original-Received: from mail-pg1-f177.google.com ([209.85.215.177]:33696) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1msYnh-0003Wr-Eo; Wed, 01 Dec 2021 18:14:10 -0500 Original-Received: by mail-pg1-f177.google.com with SMTP id f125so11904355pgc.0; Wed, 01 Dec 2021 15:14:07 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to:cc; bh=bwou4W8QHmh5uLPtPy366seFLcVUlyoOi0LOjOvrcUY=; b=gNcH8YF+0tH7p5pcCDrL54ZBJFLxU6rCcCC4UEbLndfo3qhhAb5HPlKWhum2GBOR/O GChv2966BcwLGn0h3hduvk3eNR+i9J+gg4BjfPnhtIN5T0DrwNcGneuAxa8LsdDfETY4 XdDJ9W71KqdVBdW97ZMnBsWKQEXm7Xb/hTP+6sv+UrYox3t+w4hMLULSDwKeyQiP6ixa cCgpOeyFUSyt+wXqct5Uo/ywOq24iG+N5FwyHTAL4QVWES/rD6VMvFWxUmlHk/bm1gmW /KuEYOPX0xIPBLhBddBZfOF9LRa/CwEauzkAEoozCtsbU6XFVbHDLsVmIY5mF6w1blZ5 By1w== X-Gm-Message-State: AOAM533VEMDuf6p8eppUfVaDtuZj0C1aIUy/xlPxw/Qbb37ixM6OZOwF jD/IrjSYjTbrtJLUlBtqEbnUyEgyxCz0t+MYp30= X-Google-Smtp-Source: ABdhPJzxAl0ljWgk/WVqX8EUGYTvawrcxcnE3MjySM+D0EuIxQjIXzQWYU037wx6xiLiiV344hRhuY0JcnApZBmSZOk= X-Received: by 2002:a63:f4a:: with SMTP id 10mr6805963pgp.435.1638400446532; Wed, 01 Dec 2021 15:14:06 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Wed, 1 Dec 2021 15:14:06 -0800 In-Reply-To: Received-SPF: pass client-ip=209.85.215.177; envelope-from=stefankangas@gmail.com; helo=mail-pg1-f177.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.248, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action 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: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:280701 Archived-At: Stefan Monnier writes: > As for the " (func)" I only put it there if there's room. In cases where mentioning the function is particularly important, I'd rather say function-name: Short description Given that we prefer to include package prefixes in our symbols, it should also tell you something about where the function can be found. In many cases, at least. But as you say, it is hard to find hard rules, and some creativity will inevitably be needed.