From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 19756 invoked by alias); 6 Mar 2007 04:22:13 -0000 Received: (qmail 19746 invoked by uid 22791); 6 Mar 2007 04:22:12 -0000 X-Spam-Check-By: sourceware.org Received: from heller.inter.net.il (HELO heller.inter.net.il) (213.8.233.23) by sourceware.org (qpsmtpd/0.31) with ESMTP; Tue, 06 Mar 2007 04:22:09 +0000 Received: from HOME-C4E4A596F7 (IGLD-84-229-254-221.inter.net.il [84.229.254.221]) by heller.inter.net.il (MOS 3.7.3a-GA) with ESMTP id CAX41704 (AUTH halo1); Tue, 6 Mar 2007 06:21:57 +0200 (IST) Date: Tue, 06 Mar 2007 04:22:00 -0000 Message-Id: From: Eli Zaretskii To: Jim Blandy CC: mark.kettenis@xs4all.nl, deuling@de.ibm.com, pedro_alves@portugalmail.pt, gdb-patches@sourceware.org In-reply-to: (message from Jim Blandy on Mon, 05 Mar 2007 14:01:18 -0800) Subject: Re: [Patch]: Little Cleanup Reply-to: Eli Zaretskii References: <45E7CC17.5040304@de.ibm.com> <45E93AE5.5050704@portugalmail.pt> <45EBB15E.4000602@de.ibm.com> <200703052119.l25LJKVw021917@brahms.sibelius.xs4all.nl> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2007-03/txt/msg00054.txt.bz2 > Cc: Mark Kettenis , deuling@de.ibm.com, > pedro_alves@portugalmail.pt, gdb-patches@sourceware.org > From: Jim Blandy > Date: Mon, 05 Mar 2007 14:01:18 -0800 > > The place to document the meaning of a function's return value is at > the function, not at each of its call sites. So you are saying that it's normal to expect the code reader to constantly jump to the function's definition trying to understand what its callers try to accomplish?