From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Ken Raeburn Newsgroups: gmane.emacs.devel Subject: Re: Not using DOC for ELisp files Date: Mon, 3 Jan 2022 08:48:03 -0500 Message-ID: <30e03635-843d-f3be-7709-d4b633b2c90a@raeburn.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="38291"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0) Gecko/20100101 Thunderbird/91.4.1 To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Jan 03 14:49:55 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 1n4Nil-0009mr-Qi for ged-emacs-devel@m.gmane-mx.org; Mon, 03 Jan 2022 14:49:55 +0100 Original-Received: from localhost ([::1]:33872 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n4Nik-0000eU-LF for ged-emacs-devel@m.gmane-mx.org; Mon, 03 Jan 2022 08:49:54 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:32936) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n4Nhx-000831-UR for emacs-devel@gnu.org; Mon, 03 Jan 2022 08:49:08 -0500 Original-Received: from [2607:f8b0:4864:20::729] (port=37515 helo=mail-qk1-x729.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n4Nhv-0003ZX-Ih for emacs-devel@gnu.org; Mon, 03 Jan 2022 08:49:05 -0500 Original-Received: by mail-qk1-x729.google.com with SMTP id t66so19836736qkb.4 for ; Mon, 03 Jan 2022 05:49:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=raeburn-org.20210112.gappssmtp.com; s=20210112; h=message-id:date:mime-version:user-agent:subject:content-language:to :references:from:in-reply-to:content-transfer-encoding; bh=m/HgMYSa6UBaXj8v1GS8wn5sNluLUKKB00V84Jo8pV0=; b=ncfAAAnDCOB2sPwV/ShpzP/ubfF7r3iTarY76R4WTequfCplkjRlgB86Qn+FxjyhTd X4JO8HEl2bdehXwACo5iAUJUdarawWgQL+p4Xm8K7hJ5hs+mrREnadA606qf/xO0eA/u lIR44A9oF4K5ZHKGFol4F7zy5clDPzgNUiOE+dMhXM5snvhILE+Nk7DQnRU8Uh8gBh8s 2RIfmSFn44/Bpep9ytAG+OUBWVZc2lnPniqauBmAVG/+yQjsjGRuIX0aa3B6fCNe5mTs djJiIzgCgr0vmMLgq8SuuYnYNiKW0Vn0OrA9vA5jR3Lwv8ToRemadXWDz+osCUMzlLcf wElg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:message-id:date:mime-version:user-agent:subject :content-language:to:references:from:in-reply-to :content-transfer-encoding; bh=m/HgMYSa6UBaXj8v1GS8wn5sNluLUKKB00V84Jo8pV0=; b=WRzmgn8cBMygUzTuVL+3fgYiyziBC21clcNUVM/5Agf/Od/dM994b09HMWYQKQYHTJ ZCOITL1xoH6DhVr0F1M76L3a2r5nnjztvEhFCWYWRzxX5mAgShw/ivqkofeQp0qXAwRs 05tfCNmEkxCuMWFoxZWzrMWKPnzMebSQoeAVCgKjh8vSLFiSWDLUTO5i114JklffRL3c x9NWxyDZutw6Rz6+Pgtxc/hET7/ywFwHROtu58GOtzyPndN+/stLHZ+dxI8vro6z7Prd y1PHlP9JhR+aX1Ez9UyBTkS7O1tSz4WVF0S4TYblk5A26RLWUMr8y4+5U4UbsbNFxgQW xaEg== X-Gm-Message-State: AOAM531DZEtxlfvO/Y8TWwU4Dba/508f+iI2teNSuLyRCHYUBWByII0Q ED2/dkFMdOmLI4uMRUgnuPNTljajQGEcqur4 X-Google-Smtp-Source: ABdhPJxSAso3zZmmb6Kz0CZTs7GYfimnHi0VzzE6v1S7EZAVX+0n2TxMCV2u//eXI53njxFvAW+ulQ== X-Received: by 2002:a05:620a:754:: with SMTP id i20mr31855612qki.312.1641217742039; Mon, 03 Jan 2022 05:49:02 -0800 (PST) Original-Received: from [192.168.23.135] (c-24-60-138-149.hsd1.ma.comcast.net. [24.60.138.149]) by smtp.googlemail.com with ESMTPSA id r13sm31248357qtw.41.2022.01.03.05.49.00 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 03 Jan 2022 05:49:01 -0800 (PST) Content-Language: en-US In-Reply-To: X-Host-Lookup-Failed: Reverse DNS lookup failed for 2607:f8b0:4864:20::729 (failed) Received-SPF: none client-ip=2607:f8b0:4864:20::729; envelope-from=raeburn@raeburn.org; helo=mail-qk1-x729.google.com X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) DKIM_SIGNED=0.1, DKIM_VALID=-0.1, NICE_REPLY_A=-3.354, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=unavailable 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:284047 Archived-At: On 2021-12-27 20:48, Stefan Monnier wrote: > The patch below removes from the DOC file the docstrings coming from > ELisp files. > > In numbers (in my tests), this reduces the size of DOC from about 3.2MB > to about 850kB, and increases the pdmp size by about 53kB or about 0.7%. > > The benefits aren't great, obviously, but it does remove some warts in > the `lread.c` code (into which I bumped in the `scratch/fcr` branch, > which is why this comes up now). > > I have a vague recollection that such a change was mentioned in some > bugreport-discussion some months ago but I can't remember where. > > Comments? I've only skimmed the actual code changes so far, but I think this is a good direction to go. Stefan Kargas dug up an old bug report of mine, but I think I may also have mentioned something like this in our old discussion and experimentation of doing away with unexec in favor of a big .elc file, a few years back now(!), my idea at the time being to reduce the runtime startup work done in a build without unexec. Another piece I recall looking at, which I don't remember if I brought up on the list at the time, was moving the C based doc strings into the generated .o files and the executable; in combination with removing the elisp doc strings, this would get rid of the DOC file altogether. I haven't had much time for Emacs hacking in quite a while, sadly, but if there's interest, I can try to find a little time to dig up those old changes on the C side and see how complete they were and if they can still be adapted in some form or other... Ken