From owner-svn-src-all@freebsd.org Tue Sep 20 04:53:43 2016 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 2A4BFBE029A; Tue, 20 Sep 2016 04:53:43 +0000 (UTC) (envelope-from cse.cem@gmail.com) Received: from mail-it0-f54.google.com (mail-it0-f54.google.com [209.85.214.54]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id F29311979; Tue, 20 Sep 2016 04:53:42 +0000 (UTC) (envelope-from cse.cem@gmail.com) Received: by mail-it0-f54.google.com with SMTP id n143so8482000ita.1; Mon, 19 Sep 2016 21:53:42 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:reply-to:in-reply-to:references :from:date:message-id:subject:to:cc; bh=hmJ8euYbIdYbcg0tlSX/Nfbg/lHQVi42UzdudtQwuAU=; b=WpJDtlhgAiX59bIjjETJwIfqwzI8k1dgo0N9wzWT8Vg7ORhYKOatG8rMI9wJ9Jpt+l szIXCVoqNPOnb/+90SlBDtA9PBkE4Fjdh4MlnFTU+ubNmI9UH/v4YJuYJj2sL1R1h9XU hxqgiqwWabmWpaIyMZcZ7YfbXD5NlJqkMAxVjeVLjTwcn3KgSKoctbIo2THdBUHFelsQ Judwp3iYxSSi1sMmi23ANYXRoAXMFIlCTr2yvnvutWnizVYx6809p8wEuRd0Sdt5+Hk2 raJ6qkRdad7XHaulzn41xA9fXkM0dyPvqBFoa3ZqZI+3cEkxxr6PnEagqfW+1vEOGvYQ c4pQ== X-Gm-Message-State: AE9vXwNtyeRqSSnVK01upgvneJ3UY5XH9JmLOcSVHmxnfQv3Iv2iQvNsSwBD96tveqVizw== X-Received: by 10.36.99.2 with SMTP id j2mr1959546itc.72.1474347216385; Mon, 19 Sep 2016 21:53:36 -0700 (PDT) Received: from mail-it0-f52.google.com (mail-it0-f52.google.com. [209.85.214.52]) by smtp.gmail.com with ESMTPSA id n133sm9565279ith.1.2016.09.19.21.53.36 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 19 Sep 2016 21:53:36 -0700 (PDT) Received: by mail-it0-f52.google.com with SMTP id r192so88143266ita.0; Mon, 19 Sep 2016 21:53:36 -0700 (PDT) X-Received: by 10.36.249.194 with SMTP id l185mr1788941ith.102.1474347215986; Mon, 19 Sep 2016 21:53:35 -0700 (PDT) MIME-Version: 1.0 Reply-To: cem@freebsd.org Received: by 10.36.220.129 with HTTP; Mon, 19 Sep 2016 21:53:35 -0700 (PDT) In-Reply-To: <201609200450.u8K4osHX021493@repo.freebsd.org> References: <201609200450.u8K4osHX021493@repo.freebsd.org> From: Conrad Meyer Date: Mon, 19 Sep 2016 21:53:35 -0700 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: svn commit: r306010 - head/share/man/man9 To: Warner Losh Cc: src-committers , svn-src-all@freebsd.org, svn-src-head@freebsd.org Content-Type: text/plain; charset=UTF-8 X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Sep 2016 04:53:43 -0000 Thanks! On Mon, Sep 19, 2016 at 9:50 PM, Warner Losh wrote: > Author: imp > Date: Tue Sep 20 04:50:53 2016 > New Revision: 306010 > URL: https://svnweb.freebsd.org/changeset/base/306010 > > Log: > Document existing practice and be more clear about sys/foo.h files > being alphabetical with sys/param.h or sys/types.h being first. Expand > the example to hopefully make this (slightly) clearer. > > Noticed by: cem@ > > Modified: > head/share/man/man9/style.9 > > Modified: head/share/man/man9/style.9 > ============================================================================== > --- head/share/man/man9/style.9 Tue Sep 20 04:33:58 2016 (r306009) > +++ head/share/man/man9/style.9 Tue Sep 20 04:50:53 2016 (r306010) > @@ -118,17 +118,21 @@ Leave another blank line before the head > .Pp > Kernel include files (i.e.\& > .Pa sys/*.h ) > -come first; normally, include > +come first sorted alphebetially where possible. > +Include > .In sys/types.h > OR > .In sys/param.h , > -but not both. > +but not both and include it first. > .In sys/types.h > includes > .In sys/cdefs.h , > and it is okay to depend on that. > .Bd -literal > #include /* Non-local includes in angle brackets. */ > +#include > +#include > +#include > .Ed > .Pp > For a network program, put the network include files next. >