From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756187AbbFRQw5 (ORCPT ); Thu, 18 Jun 2015 12:52:57 -0400 Received: from mail-out.m-online.net ([212.18.0.10]:43384 "EHLO mail-out.m-online.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752393AbbFRQwt (ORCPT ); Thu, 18 Jun 2015 12:52:49 -0400 X-Auth-Info: KSgONdErAhUxseGEgMhC6iUQEfaqfZR4cx13rqw2GBjnsAAHn+1tgm0bxoMOEZDA From: Andreas Schwab To: Finn Thain Cc: Geert Uytterhoeven , "linux-kernel\@vger.kernel.org" , Linux/m68k , "linuxppc-dev\@lists.ozlabs.org" , "linux-api\@vger.kernel.org" Subject: Re: [RFC v2 23/24] m68k/mac: Fix PRAM accessors References: <20150614074607.242676098@telegraphics.com.au> <20150614074613.054681242@telegraphics.com.au> X-Yow: YOW!!! I am having fun!!! Date: Thu, 18 Jun 2015 18:52:44 +0200 In-Reply-To: (Finn Thain's message of "Tue, 16 Jun 2015 13:10:29 +1000 (AEST)") Message-ID: <87a8vxarhf.fsf@igel.home> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Finn Thain writes: > When I have reliable documentation I always define macros. So I agree that > "command" bytes like 0x34 and 0x3800 should have names but what are the > correct names? Are we constructing an opcode containing RTC register file > addresses or are we issuing read/write accesses to chip registers? Any name will do as long as the magic constant is not duplicated. It is more important to document the relation between two uses than to have a correct name (which can trivially be updated later). Andreas. -- Andreas Schwab, schwab@linux-m68k.org GPG Key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5 "And now for something completely different."