From owner-freebsd-doc@FreeBSD.ORG Thu Jan 16 08:52:10 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id DE45E3FC for ; Thu, 16 Jan 2014 08:52:10 +0000 (UTC) Received: from mail-qe0-x248.google.com (mail-qe0-x248.google.com [IPv6:2607:f8b0:400d:c02::248]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id A13A11E44 for ; Thu, 16 Jan 2014 08:52:10 +0000 (UTC) Received: by mail-qe0-f72.google.com with SMTP id 5so3627195qeb.11 for ; Thu, 16 Jan 2014 00:52:09 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:message-id:date:subject:from:to:content-type; bh=AFZkcso2yU9NhsKy7DZGb8kJ3Yz2EX5S8c+KjBFhdo0=; b=vXl1lO0jJL16BbK+YjyTgV7HFeHyFt98/OiGNGS1oOgAl2gTLC1lbBoclRZyW6f88a cx+WL5Hal7rszZXjSWqv9TXk3yyHCt6l+6cijgjUyDsBx6m686VAQMYxu5AKi+465ZEW 6dOaBtDeUZCVAl0Zmq0+k4n0iiZZq2aWJqBIq8PeNNwaAzR2btuFPwvCYWEfAtqBStwA 09B3UztCFdrjMM1lcsJV3SLF5PgulitfTpmCdEEjs8Z3GCWUqGNk4CRdlMH6ncLvPhgx Vb2/33Z3vUIUqhmM8lYSu9MVASGDB1SnIa0V0kniGm7FYbhpCf8klSflaD89OTAyMbW1 E/WQ== MIME-Version: 1.0 X-Received: by 10.236.165.133 with SMTP id e5mr2543630yhl.31.1389862329800; Thu, 16 Jan 2014 00:52:09 -0800 (PST) Message-ID: <20cf3040e62474712004f0128a6f@google.com> Date: Thu, 16 Jan 2014 08:52:09 +0000 Subject: www.freebsd.org From: Mayleen Ying To: doc@freebsd.org Content-Type: text/plain; charset=windows-1252; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Jan 2014 08:52:10 -0000 PGRpdiBkaXI9Imx0ciI+PHA+SGksPC9wPjxkaXY+PHA+SSB3YW50ZWQgdG8gc2VuZCB5b3UgYSBx dWljayBub3RlLiBXaXRoIGEgIA0KZmV3IHNpbXBsZSBjaGFuZ2VzIHRvIG1ha2UgeW91ciBzaXRl IG1vcmUgU0VPLWZyaWVuZGx5IEmSbSBzdXJlIHlvdSBjYW4gIA0KY29udmVydCBtb3JlIHZpc2l0 b3JzIGludG8gbGVhZHMgYW5kIGdldCBpdCBwbGFjZWQgaGlnaGVyIGluIHRoZSBvcmdhbmljICAN CnNlYXJjaCByZXN1bHRzLCBmb3Iga2V5d29yZHMgdGhhdCBtYXR0ZXIgdG8geW91IHRoZSBtb3N0 LjwvcD4NCg0KPC9kaXY+PGRpdj48cD5XZSBhcmUgYSBMb2NhbCBiYXNlZCBjb21wYW55IHdpdGgg Z3JlYXQgaW4taG91c2UgdGVjaG5pY2FsICANCnRlYW0gd2hvIHJlYWxseSBrbm93IHRoZWlyIHN0 dWZmIGFib3V0IHNlYXJjaCBlbmdpbmUgIA0Kb3B0aW1pemF0aW9uLqA8L3A+PC9kaXY+PHA+V291 bGQgeW91IGxpa2UgYSBiaXQgbW9yZSBpbmZvcm1hdGlvbiBhYm91dCBob3cgIA0KdG8gZ2l2ZSB5 b3VyIHdlYnNpdGUgYSBib29zdCB3aXRoIGJldHRlciBTRU8/PC9wPg0KDQo8cD5CZXN0IHJlZ2Fy ZHMsPC9wPjxwPjxzcGFuIHN0eWxlPSJmb250LWZhbWlseTomIzM5O2Jvb2sgIA0KYW50aXF1YSYj Mzk7LHBhbGF0aW5vO2NvbG9yOnJnYigxMzYsMTM2LDEzNikiPjxmb250IHNpemU9IjQiPk1heWxl ZW4gIA0KWWluZzwvZm9udD48YnI+PHNwYW4gIA0Kc3R5bGU9ImNvbG9yOnJnYigwLDAsMCk7Zm9u dC1mYW1pbHk6YXJpYWwsaGVsdmV0aWNhLHNhbnMtc2VyaWY7Zm9udC1zaXplOnh4LXNtYWxsIj5T RU8vV0VCICANClNwZWNpYWxpc3Q8L3NwYW4+PC9zcGFuPjwvcD4NCg0KPHRhYmxlIHN0eWxlPSJt YXJnaW4tbGVmdDphdXRvO21hcmdpbi1yaWdodDphdXRvIiAgDQpib3JkZXI9IjAiPjx0Ym9keT48 dHI+PHRkPqCgoKCgoKCgoKA8L3RkPjx0ZCAgDQpzdHlsZT0iYmFja2dyb3VuZC1jb2xvcjpyZ2Io NzIsMTE0LDIzMykiPjxiPqA8L2I+oDxzcGFuICANCnN0eWxlPSJmb250LWZhbWlseTomIzM5O3Rp bWVzIG5ldyAgDQpyb21hbiYjMzk7LHRpbWVzO2ZvbnQtc2l6ZTpsYXJnZTtjb2xvcjpyZ2IoMjU1 LDI1NSwyNTUpIj5TPC9zcGFuPjxiPqCgPC9iPjwvdGQ+DQoNCjx0ZCBzdHlsZT0iYmFja2dyb3Vu ZC1jb2xvcjpyZ2IoMjU1LDAsNTEpIj6gPHNwYW4gIA0Kc3R5bGU9ImZvbnQtZmFtaWx5OiYjMzk7 dGltZXMgbmV3IHJvbWFuJiMzOTssdGltZXM7Zm9udC1zaXplOmxhcmdlIj48c3BhbiAgDQpzdHls ZT0iZm9udC1zaXplOngtbGFyZ2U7Y29sb3I6cmdiKDI1NSwyNTUsMjU1KSI+RTwvc3Bhbj6gPC9z cGFuPjwvdGQ+PHRkICANCnN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOnJnYigxMDEsMjM1LDE5KSI+ DQoNCjxzcGFuIHN0eWxlPSJmb250LXNpemU6bGFyZ2U7Y29sb3I6cmdiKDI1NSwyNTUsMjU1KTtm b250LWZhbWlseTomIzM5O3RpbWVzICANCm5ldyByb21hbiYjMzk7LHRpbWVzIj6gT6A8L3NwYW4+ PC90ZD48dGQgIA0Kc3R5bGU9InRleHQtYWxpZ246Y2VudGVyIj6goKAgoCCgIKAgoDwvdGQ+PC90 cj48dHI+PHRkIGNvbHNwYW49IjUiICANCnN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOnJnYigwLDAs MCk7dGV4dC1hbGlnbjpjZW50ZXIiPg0KDQo8Yj48c3BhbiAgDQpzdHlsZT0iZm9udC1mYW1pbHk6 dGFob21hLGFyaWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2NvbG9yOnJnYigyNTUsMjU1LDI1NSki PlNlYXJjaCAgDQpFbmdpbmUgT3B0aW1pemF0aW9uPC9zcGFuPjwvYj48L3RkPjwvdHI+PC90Ym9k eT48L3RhYmxlPjxwICANCnN0eWxlPSJ0ZXh0LWFsaWduOmNlbnRlciI+PHNwYW4gIA0Kc3R5bGU9 ImZvbnQtZmFtaWx5OmFyaWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2ZvbnQtc2l6ZTp4eC1zbWFs bDtjb2xvcjpyZ2IoMTM2LDEzNiwxMzYpIj5XZSAgDQpyZXNwZWN0IHlvdXIgcHJpdmFjeSBhbmQg d2FudCB0byBtYWtlIHN1cmUgeW91IGFyZSBhd2FyZSBvZiBhIGZldyB0aGluZ3MuICANCkJ5IHJl cGx5aW5nIHRvIHRoaXMgZW1haWwsIHlvdSBhdXRob3JpemUgb3VyIEhvbmcgS29uZyBhZmZpbGlh dGVzIHRoYXQgY2FuICANCmhlbHAgd2l0aCB5b3VyIHByb2plY3QgdG8gY2FsbCB5b3UgYXQgdGhl IG51bWJlciB5b3UgcHJvdmlkZWQsIGFuZCB5b3UgIA0KdW5kZXJzdGFuZCB0aGF0IHRoZXkgbWF5 IHVzZSBhdXRvbWF0ZWQgcGhvbmUgdGVjaG5vbG9neSB0byBjYWxsIHlvdS4gQXQgbm8gIA0KdGlt ZSBhcmUgeW91IHJlcXVpcmVkIHRvIG1ha2UgYSBwdXJjaGFzZS48L3NwYW4+PC9wPg0KDQo8ZGl2 IHN0eWxlPSJ0ZXh0LWFsaWduOmNlbnRlciI+PHNwYW4gIA0Kc3R5bGU9ImZvbnQtZmFtaWx5OmFy aWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2ZvbnQtc2l6ZTp4eC1zbWFsbDtjb2xvcjpyZ2IoMTM2 LDEzNiwxMzYpIj5VbnN1YnNjcmliZTwvc3Bhbj48L2Rpdj48L2Rpdj4NCg== From owner-freebsd-doc@FreeBSD.ORG Thu Jan 16 08:57:04 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 3C7B250A for ; Thu, 16 Jan 2014 08:57:04 +0000 (UTC) Received: from mail-ie0-x247.google.com (mail-ie0-x247.google.com [IPv6:2607:f8b0:4001:c03::247]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 0E5C91E76 for ; Thu, 16 Jan 2014 08:57:04 +0000 (UTC) Received: by mail-ie0-f199.google.com with SMTP id x13so10240221ief.6 for ; Thu, 16 Jan 2014 00:57:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:message-id:date:subject:from:to:content-type; bh=nAAeyLhcQR+vX2Wg44cssGr0Un0wjaGqhdUuo9cFVoU=; b=oWyJO5wkM4AgOTyibDOQZJmY3FcUgS5/uNWZPlGYSrbZ19Ld9YYJISKHrAKGMr8/Z1 SX6klklsijZXHZoaFjU3izjbtSB0bfirLYU8ZFeT8/Qh9gQsmjNe9ec3+Z08t/fG81ra z7i0w5sK61gbvNNpG8kqoREC45G4CHJGigga5MzEsWisR2I7Q75Xk+BGWCCFK3F4nt8F OXKQQ305L0DPo/90zm3GHlo64cTQqLHv3yykKywuC9xhXgwuDCYxqGUsRoB/zdNpr2YD zKbhrCOGipneA+LZbQYcWxT2uvYAXpQO2vZiMsH7oR9dPIuIZTMXxY+JRUUFQWRsxB1T aFsg== MIME-Version: 1.0 X-Received: by 10.182.236.74 with SMTP id us10mr2780451obc.36.1389862623546; Thu, 16 Jan 2014 00:57:03 -0800 (PST) Message-ID: <001a11c329d2f6925b04f0129bb0@google.com> Date: Thu, 16 Jan 2014 08:57:03 +0000 Subject: www.freebsd.org From: Mayleen Ying To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=windows-1252; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Jan 2014 08:57:04 -0000 PGRpdiBkaXI9Imx0ciI+PHA+SGksPC9wPjxkaXY+PHA+SSB3YW50ZWQgdG8gc2VuZCB5b3UgYSBx dWljayBub3RlLiBXaXRoIGEgIA0KZmV3IHNpbXBsZSBjaGFuZ2VzIHRvIG1ha2UgeW91ciBzaXRl IG1vcmUgU0VPLWZyaWVuZGx5IEmSbSBzdXJlIHlvdSBjYW4gIA0KY29udmVydCBtb3JlIHZpc2l0 b3JzIGludG8gbGVhZHMgYW5kIGdldCBpdCBwbGFjZWQgaGlnaGVyIGluIHRoZSBvcmdhbmljICAN CnNlYXJjaCByZXN1bHRzLCBmb3Iga2V5d29yZHMgdGhhdCBtYXR0ZXIgdG8geW91IHRoZSBtb3N0 LjwvcD4NCg0KPC9kaXY+PGRpdj48cD5XZSBhcmUgYSBMb2NhbCBiYXNlZCBjb21wYW55IHdpdGgg Z3JlYXQgaW4taG91c2UgdGVjaG5pY2FsICANCnRlYW0gd2hvIHJlYWxseSBrbm93IHRoZWlyIHN0 dWZmIGFib3V0IHNlYXJjaCBlbmdpbmUgIA0Kb3B0aW1pemF0aW9uLqA8L3A+PC9kaXY+PHA+V291 bGQgeW91IGxpa2UgYSBiaXQgbW9yZSBpbmZvcm1hdGlvbiBhYm91dCBob3cgIA0KdG8gZ2l2ZSB5 b3VyIHdlYnNpdGUgYSBib29zdCB3aXRoIGJldHRlciBTRU8/PC9wPg0KDQo8cD5CZXN0IHJlZ2Fy ZHMsPC9wPjxwPjxzcGFuIHN0eWxlPSJmb250LWZhbWlseTomIzM5O2Jvb2sgIA0KYW50aXF1YSYj Mzk7LHBhbGF0aW5vO2NvbG9yOnJnYigxMzYsMTM2LDEzNikiPjxmb250IHNpemU9IjQiPk1heWxl ZW4gIA0KWWluZzwvZm9udD48YnI+PHNwYW4gIA0Kc3R5bGU9ImNvbG9yOnJnYigwLDAsMCk7Zm9u dC1mYW1pbHk6YXJpYWwsaGVsdmV0aWNhLHNhbnMtc2VyaWY7Zm9udC1zaXplOnh4LXNtYWxsIj5T RU8vV0VCICANClNwZWNpYWxpc3Q8L3NwYW4+PC9zcGFuPjwvcD4NCg0KPHRhYmxlIHN0eWxlPSJt YXJnaW4tbGVmdDphdXRvO21hcmdpbi1yaWdodDphdXRvIiAgDQpib3JkZXI9IjAiPjx0Ym9keT48 dHI+PHRkPqCgoKCgoKCgoKA8L3RkPjx0ZCAgDQpzdHlsZT0iYmFja2dyb3VuZC1jb2xvcjpyZ2Io NzIsMTE0LDIzMykiPjxiPqA8L2I+oDxzcGFuICANCnN0eWxlPSJmb250LWZhbWlseTomIzM5O3Rp bWVzIG5ldyAgDQpyb21hbiYjMzk7LHRpbWVzO2ZvbnQtc2l6ZTpsYXJnZTtjb2xvcjpyZ2IoMjU1 LDI1NSwyNTUpIj5TPC9zcGFuPjxiPqCgPC9iPjwvdGQ+DQoNCjx0ZCBzdHlsZT0iYmFja2dyb3Vu ZC1jb2xvcjpyZ2IoMjU1LDAsNTEpIj6gPHNwYW4gIA0Kc3R5bGU9ImZvbnQtZmFtaWx5OiYjMzk7 dGltZXMgbmV3IHJvbWFuJiMzOTssdGltZXM7Zm9udC1zaXplOmxhcmdlIj48c3BhbiAgDQpzdHls ZT0iZm9udC1zaXplOngtbGFyZ2U7Y29sb3I6cmdiKDI1NSwyNTUsMjU1KSI+RTwvc3Bhbj6gPC9z cGFuPjwvdGQ+PHRkICANCnN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOnJnYigxMDEsMjM1LDE5KSI+ DQoNCjxzcGFuIHN0eWxlPSJmb250LXNpemU6bGFyZ2U7Y29sb3I6cmdiKDI1NSwyNTUsMjU1KTtm b250LWZhbWlseTomIzM5O3RpbWVzICANCm5ldyByb21hbiYjMzk7LHRpbWVzIj6gT6A8L3NwYW4+ PC90ZD48dGQgIA0Kc3R5bGU9InRleHQtYWxpZ246Y2VudGVyIj6goKAgoCCgIKAgoDwvdGQ+PC90 cj48dHI+PHRkIGNvbHNwYW49IjUiICANCnN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOnJnYigwLDAs MCk7dGV4dC1hbGlnbjpjZW50ZXIiPg0KDQo8Yj48c3BhbiAgDQpzdHlsZT0iZm9udC1mYW1pbHk6 dGFob21hLGFyaWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2NvbG9yOnJnYigyNTUsMjU1LDI1NSki PlNlYXJjaCAgDQpFbmdpbmUgT3B0aW1pemF0aW9uPC9zcGFuPjwvYj48L3RkPjwvdHI+PC90Ym9k eT48L3RhYmxlPjxwICANCnN0eWxlPSJ0ZXh0LWFsaWduOmNlbnRlciI+PHNwYW4gIA0Kc3R5bGU9 ImZvbnQtZmFtaWx5OmFyaWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2ZvbnQtc2l6ZTp4eC1zbWFs bDtjb2xvcjpyZ2IoMTM2LDEzNiwxMzYpIj5XZSAgDQpyZXNwZWN0IHlvdXIgcHJpdmFjeSBhbmQg d2FudCB0byBtYWtlIHN1cmUgeW91IGFyZSBhd2FyZSBvZiBhIGZldyB0aGluZ3MuICANCkJ5IHJl cGx5aW5nIHRvIHRoaXMgZW1haWwsIHlvdSBhdXRob3JpemUgb3VyIEhvbmcgS29uZyBhZmZpbGlh dGVzIHRoYXQgY2FuICANCmhlbHAgd2l0aCB5b3VyIHByb2plY3QgdG8gY2FsbCB5b3UgYXQgdGhl IG51bWJlciB5b3UgcHJvdmlkZWQsIGFuZCB5b3UgIA0KdW5kZXJzdGFuZCB0aGF0IHRoZXkgbWF5 IHVzZSBhdXRvbWF0ZWQgcGhvbmUgdGVjaG5vbG9neSB0byBjYWxsIHlvdS4gQXQgbm8gIA0KdGlt ZSBhcmUgeW91IHJlcXVpcmVkIHRvIG1ha2UgYSBwdXJjaGFzZS48L3NwYW4+PC9wPg0KDQo8ZGl2 IHN0eWxlPSJ0ZXh0LWFsaWduOmNlbnRlciI+PHNwYW4gIA0Kc3R5bGU9ImZvbnQtZmFtaWx5OmFy aWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2ZvbnQtc2l6ZTp4eC1zbWFsbDtjb2xvcjpyZ2IoMTM2 LDEzNiwxMzYpIj5VbnN1YnNjcmliZTwvc3Bhbj48L2Rpdj48L2Rpdj4NCg== From owner-freebsd-doc@FreeBSD.ORG Fri Jan 17 10:14:34 2014 Return-Path: Delivered-To: www@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id E83ACC2B for ; Fri, 17 Jan 2014 10:14:33 +0000 (UTC) Received: from mail-ie0-x250.google.com (mail-ie0-x250.google.com [IPv6:2607:f8b0:4001:c03::250]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id BA5651338 for ; Fri, 17 Jan 2014 10:14:33 +0000 (UTC) Received: by mail-ie0-f208.google.com with SMTP id e14so77806iej.3 for ; Fri, 17 Jan 2014 02:14:33 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:message-id:date:subject:from:to:content-type; bh=Pf600LbwRPEkuDl56K1wcghqcbHZUgaUB2X+eOVMF1w=; b=P2a8+kY/zUiDpmxQ5PBaiDKl8fwHktLKrX2OAvXioxhr7iqO4xDVeANOa63VSn1N+t iwL1zZd8N5bEyN7Pri1xlX2akBJbL0xGR5jLS86wAQMOBryknNYOwR7U/t5O5h6RqLFr dw+VgwoUwFhlFS70MoOklrWvksH8Y9I5n6VdjlPulld56DbcVXUz3oh9ztV7afxav1ap HuhHRZ2YD24bE1NJrhBf0KLVOqBj0FBiZMqxxordO+XaG/KWehY41BNQ3qHTqFsMkhfu SC4nQyIipCmwjMK6uVRPtw5iaQ+JvmYFfqUFXqOnYT9+rYUJdW7VamFZIbeFc+2asgqG e3kw== MIME-Version: 1.0 X-Received: by 10.182.246.39 with SMTP id xt7mr394038obc.40.1389953673266; Fri, 17 Jan 2014 02:14:33 -0800 (PST) Message-ID: <001a11c2e224f30a1604f027cee3@google.com> Date: Fri, 17 Jan 2014 10:14:33 +0000 Subject: From: Liu Jing To: www@freebsd.org Content-Type: text/plain; charset=windows-1252; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 17 Jan 2014 10:14:34 -0000 DQoNCiAgSGksDQoNCkkganVzdCB3YW50ZWQgdG8gc2VuZCB5b3UgYSBxdWljayBub3RlLiBXaXRo IGEgZmV3IHNpbXBsZSBjaGFuZ2VzIHRvIG1ha2UNCnlvdXIgc2l0ZSBtb3JlIFNFTy1mcmllbmRs eSBJkm0gc3VyZSB5b3UgY2FuIGNvbnZlcnQgbW9yZSB2aXNpdG9ycyBpbnRvDQpsZWFkcyBhbmQg Z2V0IGl0IHBsYWNlZCBoaWdoZXIgaW4gdGhlIG9yZ2FuaWMgc2VhcmNoIHJlc3VsdHMsIGZvciBr ZXl3b3Jkcw0KdGhhdCBtYXR0ZXIgdG8geW91IHRoZSBtb3N0Lg0KDQpXZSBhcmUgSG9uZyBLb25n IGJhc2VkIGNvbXBhbnkgd2l0aCBhIGdyZWF0IGluLWhvdXNlIHRlY2huaWNhbCB0ZWFtIHdobw0K cmVhbGx5IGtub3cgdGhlaXIgc3R1ZmYgYWJvdXQgc2VhcmNoIGVuZ2luZSBvcHRpbWl6YXRpb24u DQoNCldvdWxkIHlvdSBsaWtlIGEgYml0IG1vcmUgaW5mb3JtYXRpb24gYWJvdXQgaG93IHRvIGdp dmUgeW91ciB3ZWJzaXRlIGENCmJvb3N0IHdpdGggYmV0dGVyIFNFTz8NCg0KQmVzdCByZWdhcmRz LA0KDQpMaXUgSmluZw0KU0VPL1dFQiBTcGVjaWFsaXN0DQoNCltpbWFnZTogTGlua2VkSW5dIFtp bWFnZTogRmFjZWJvb2tdIFtpbWFnZTogVHdpdHRlcl0gW2ltYWdlOiBTa3lwZV0NCiAgICAgICAg ICAgICBTICAgRSAgTyAgICAgICAgICAgICpTZWFyY2ggRW5naW5lIE9wdGltaXphdGlvbioNCg0K V2UgcmVzcGVjdCB5b3VyIHByaXZhY3kgYW5kIHdhbnQgdG8gbWFrZSBzdXJlIHlvdSBhcmUgYXdh cmUgb2YgYSBmZXcNCnRoaW5ncy4gQnkgcmVwbHlpbmcgdG8gdGhpcyBlbWFpbCwgeW91IGF1dGhv cml6ZSBvdXIgSEsgYWZmaWxpYXRlcyB0aGF0IGNhbg0KaGVscCB3aXRoIHlvdXIgcHJvamVjdCB0 byBjYWxsIHlvdSBhdCB0aGUgbnVtYmVyIHlvdSBwcm92aWRlZCwgYW5kIHlvdQ0KdW5kZXJzdGFu ZCB0aGF0IHRoZXkgbWF5IHVzZSBhdXRvbWF0ZWQgcGhvbmUgdGVjaG5vbG9neSB0byBjYWxsIHlv dS4gQXQgbm8NCnRpbWUgYXJlIHlvdSByZXF1aXJlZCB0byBtYWtlIGEgcHVyY2hhc2UuDQo= From owner-freebsd-doc@FreeBSD.ORG Fri Jan 17 12:42:33 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id C9DBB678 for ; Fri, 17 Jan 2014 12:42:33 +0000 (UTC) Received: from mail-pb0-x247.google.com (mail-pb0-x247.google.com [IPv6:2607:f8b0:400e:c01::247]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id A47B51EEE for ; Fri, 17 Jan 2014 12:42:33 +0000 (UTC) Received: by mail-pb0-f71.google.com with SMTP id jt11so4442529pbb.2 for ; Fri, 17 Jan 2014 04:42:33 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:message-id:date:subject:from:to:content-type; bh=BlrGIuy14Nw/poWeWtBbMx5IImaiItfYF47sY6TU0j4=; b=L9Ym5sp03pw9fWxUYrUUGVJGcwlX6+Jg/f7jfGubjxVDpRkiRglazxJZU9a8TSxKu/ vtunJJgiPbBmSVR8dmzPSHNin2Dgvh2FBCAirFwdIa1WB089pgvyLD3VBpIUCkbuCexI ldbFiGVqh1evP4wPSVIvEr7Lq23utvUIo9mnbAs9Xrq5d/EAhsE4qVmc5V1M5dSTl3Wu 0ow6A+DnPyQA7A9D1STuVg+Qg6VimAFmjeSnI77iZsysTaC7UV3fU2sB/6mhEBWZWum7 nSPwOCLIquZJco4SsCwCUC7n6Bw/wJzFROB+mia+rgqtfC1DazBlkltNofIghHgk0EpM PiKQ== MIME-Version: 1.0 X-Received: by 10.66.222.105 with SMTP id ql9mr666715pac.9.1389962553150; Fri, 17 Jan 2014 04:42:33 -0800 (PST) Message-ID: <047d7b5dae5a3b558204f029e028@google.com> Date: Fri, 17 Jan 2014 12:42:33 +0000 Subject: www.freebsd.org From: Tayla Niland To: doc@freebsd.org Content-Type: text/plain; charset=windows-1252; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 17 Jan 2014 12:42:33 -0000 SGksDQoNCkkgd2FudGVkIHRvIHNlbmQgeW91IGEgcXVpY2sgbm90ZS4gV2l0aCBhIGZldyBzaW1w bGUgY2hhbmdlcyB0byBtYWtlIHlvdXINCnNpdGUgbW9yZSBTRU8tZnJpZW5kbHkgSZJtIHN1cmUg eW91IGNhbiBjb252ZXJ0IG1vcmUgdmlzaXRvcnMgaW50byBsZWFkcw0KYW5kIGdldCBpdCBwbGFj ZWQgaGlnaGVyIGluIHRoZSBvcmdhbmljIHNlYXJjaCByZXN1bHRzLCBmb3Iga2V5d29yZHMgdGhh dA0KbWF0dGVyIHRvIHlvdSB0aGUgbW9zdC4NCg0KV2UgYXJlIGFuIEF1c3RyYWxpYW4gYmFzZWQg Y29tcGFueSB3aXRoIGEgZ3JlYXQgaW4taG91c2UgdGVjaG5pY2FsIHRlYW0gd2hvDQpyZWFsbHkg a25vdyB0aGVpciBzdHVmZiBhYm91dCBzZWFyY2ggZW5naW5lIG9wdGltaXphdGlvbi4NCg0KV291 bGQgeW91IGxpa2UgYSBiaXQgbW9yZSBpbmZvcm1hdGlvbiBhYm91dCBob3cgdG8gZ2l2ZSB5b3Vy IHdlYnNpdGUgYQ0KYm9vc3Qgd2l0aCBiZXR0ZXIgU0VPPw0KDQpCZXN0IHJlZ2FyZHMsDQoNClRh eWxhIE5pbGFuZA0KDQpTRU8vV0VCIFNwZWNpYWxpc3QNCg0KRTogdGF5bGFuaWxhbmQzQGdtYWls LmNvbQ0KDQpbaW1hZ2U6IExpbmtlZEluXSBbaW1hZ2U6IEZhY2Vib29rXSBbaW1hZ2U6IFR3aXR0 ZXJdIFtpbWFnZTogU2t5cGVdDQogICAgICAgICAgICAgUyAgIEUgIE8gICAgICAgICAgICAqU2Vh cmNoIEVuZ2luZSBPcHRpbWl6YXRpb24qDQoqQCAqUVVFRU5TTEFORCwgTlNXLCBWSUNUT1JJQSwg U09VVEggQVVTVFJBTElBLCBXRVNURVJOIEFVU1RSQUxJQSwgTk9SVEhFUk4NClRFUlJJVE9SWSwg VEFTTUFOSUEsIEFDVA0KDQpXZSByZXNwZWN0IHlvdXIgcHJpdmFjeSBhbmQgd2FudCB0byBtYWtl IHN1cmUgeW91IGFyZSBhd2FyZSBvZiBhIGZldw0KdGhpbmdzLiBCeSByZXBseWluZyB0byB0aGlz IGVtYWlsLCB5b3UgYXV0aG9yaXplIG91ciBBdXN0cmFsaWFuIGFmZmlsaWF0ZXMNCnRoYXQgY2Fu IGhlbHAgd2l0aCB5b3VyIHByb2plY3QgdG8gY2FsbCB5b3UgYXQgdGhlIG51bWJlciB5b3UgcHJv dmlkZWQsIGFuZA0KeW91IHVuZGVyc3RhbmQgdGhhdCB0aGV5IG1heSB1c2UgYXV0b21hdGVkIHBo b25lIHRlY2hub2xvZ3kgdG8gY2FsbCB5b3UuIEF0DQpubyB0aW1lIGFyZSB5b3UgcmVxdWlyZWQg dG8gbWFrZSBhIHB1cmNoYXNlLg0KVW5zdWJzY3JpYlRhc3kNCg== From owner-freebsd-doc@FreeBSD.ORG Fri Jan 17 14:14:40 2014 Return-Path: Delivered-To: doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 1033) id 2D1E6C2; Fri, 17 Jan 2014 14:14:40 +0000 (UTC) Date: Fri, 17 Jan 2014 14:14:40 +0000 From: Alexey Dokuchaev To: Pietro Cerutti Subject: [patch] PH tells crap about GMAKE (Was: Re: svn commit: r340018 - head/textproc/scew) Message-ID: <20140117141440.GA94157@FreeBSD.org> References: <201401170910.s0H9Aw9O087448@svn.freebsd.org> <20140117093546.GA16656@FreeBSD.org> <20140117095020.GD4006@gahrfit.gahr.ch> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="9jxsPFA5p3P2qPhR" Content-Disposition: inline In-Reply-To: <20140117095020.GD4006@gahrfit.gahr.ch> User-Agent: Mutt/1.5.22 (2013-10-16) Cc: doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 17 Jan 2014 14:14:40 -0000 --9jxsPFA5p3P2qPhR Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Fri, Jan 17, 2014 at 10:50:21AM +0100, Pietro Cerutti wrote: > On 2014-Jan-17, 09:35, Alexey Dokuchaev wrote: > > If possible, particular make(1) implementation should not be referenced in > > port's Makefile. If you need to call "correct" make(1), use ${MAKE_CMD}, > > which would be correctly set to "gmake" in this case of yours (per USES= > > gmake). > > That makes sense. What about updating [section] 6.4.2 of the porter's > handbook? Indeed, this section needs some love. Even more, I think it tells something that is not true: "GMAKE [variables contains] The full path for gmake if it is not in the PATH." GMAKE is defined in Mk/bsd.commands.mk, and equals to simply "gmake". It is one of the rare cases when absolute (or relative to ${LOCALBASE}) path is not used. I did not observe any indication of some PATH inspection to conditionally set GMAKE variable under /usr/ports/Mk. I also think that Table 6.1 which consists of two rows and columns is, hm, ridicule, I guess. :) IMHO it should be removed. Please consider attached patch. It is not a polished gem, and most likely would need a review and wordsmithing from doc@ guys. While here I've also standardized the spelling of "okay", and fixed couple of grammar nits. These changes are not related to GMAKE ones, and probably should be committed separately, but I'm not splitting the diff for personal convenience, sorry. :) ./danfe --9jxsPFA5p3P2qPhR Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="ph-gmake.diff" Index: book.xml =================================================================== --- book.xml (revision 43554) +++ book.xml (working copy) @@ -201,7 +201,7 @@ README or manpage; too often they are not a concise description of the port or are in an awkward format (e.g., manpages have justified - spacing, as it looks particularly bad with monospaced + spacing, which looks particularly bad with monospaced fonts). @@ -515,7 +515,7 @@ Slow Porting - Ok, so it was not that simple, and the port required some + Okay, so it was not that simple, and the port required some modifications to get it to work. In this section, we will explain, step by step, how to modify it to get it to work with the ports paradigm. @@ -4128,7 +4128,7 @@ Available USE_ and WANT_ variables are defined in the files - in /usr/ports/Mk. + under /usr/ports/Mk directory. @@ -5644,40 +5644,32 @@ - <command>make</command>, <command>gmake</command>, and - <command>imake</command> + <command>make</command>, <command>gmake</command>, + <command>fmake</command>, and <command>imake</command> + Several make implementations exist and + are in use. Quite often, you would have to use a particular + one, e.g. GNU make, or legacy FreeBSD make. + If your port uses GNU make, - set USES= gmake. + add gmake to USES. If + you must use legacy FreeBSD make, add fmake + there. - - Variables for Ports Related to - <application>gmake</application> + When you need to reference make command + that depends on USES value in a port's + Makefile, you should use + MAKE_CMD. In rare cases, when you need to + list several different make implementations + in USES, you can use variables + GMAKE (for GNU version) or + FMAKE (for legacy FreeBSD version), assuming + that you have set USES appropriately, but + most likely you would never have to go that far. Most, if not + all ports should only use MAKE_CMD within + their Makefiles (that is, to call make + implementation expected by the ported software). - - - - Variable - Means - - - - - - USES= gmake - The port requires gmake to - build. - - - - GMAKE - The full path for gmake if - it is not in the PATH. - - - -
- If your port is an X application that creates Makefile files from Imakefile files using --9jxsPFA5p3P2qPhR--