From owner-freebsd-doc@FreeBSD.ORG Wed Jun 24 08:03:18 2009 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3AEF3106566C; Wed, 24 Jun 2009 08:03:18 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from mail-bw0-f209.google.com (mail-bw0-f209.google.com [209.85.218.209]) by mx1.freebsd.org (Postfix) with ESMTP id 55E808FC19; Wed, 24 Jun 2009 08:03:17 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by bwz5 with SMTP id 5so527454bwz.43 for ; Wed, 24 Jun 2009 01:03:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :x-enigmail-version:content-type:content-transfer-encoding; bh=pD3+aEXxAso906jJNRYnT1WzidmpfxUaUTRMDfQyMRo=; b=Sq2o21DiZWCafmdZ2M9T8kcPG4UXkIfG4nybH1e2AVV6yskGPVNhTcZqO7YW0APtE5 Ppi9TPrCzQuOFHztOPc62HaFgO9IoGDNzAnmcKVokfXg9L3G2PwvKLoplQnqzaEnxgXW KIz9AkW9pFUnq4siTwdGEeNBMaI1T1Llt+OVw= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; b=o9TPXYX1k/Pnwd26SQ0BdMkaa+7T4ZcetCC3QNuALlcwxs8wlKDE8pqgp5cOSDz9w7 IdlOycvraRjuqlGPokX0+zU0/ujHp7iBGzkYgjKCxrI5Y8kFomJWl4vof7j8cEXVmymc Ccx1WXP8I/jn2HVfXGY6aX0U6KWHoRCnSQjrI= Received: by 10.204.102.14 with SMTP id e14mr961204bko.209.1245829052291; Wed, 24 Jun 2009 00:37:32 -0700 (PDT) Received: from atomic.dyndns.org (athedsl-4488595.home.otenet.gr [94.71.73.155]) by mx.google.com with ESMTPS id z10sm1315660fka.35.2009.06.24.00.37.30 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 24 Jun 2009 00:37:31 -0700 (PDT) Message-ID: <4A41D7B9.1030203@gmail.com> Date: Wed, 24 Jun 2009 10:37:29 +0300 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.21 (X11/20090414) MIME-Version: 1.0 To: Tom Rhodes References: <200906240730.n5O7U6ZA048963@freefall.freebsd.org> In-Reply-To: <200906240730.n5O7U6ZA048963@freefall.freebsd.org> X-Enigmail-Version: 0.95.7 Content-Type: text/plain; charset=ISO-8859-7 Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org, bug-followup@FreeBSD.org Subject: Re: docs/135983: "The Z File System" - title is misleading and causes search issue X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 24 Jun 2009 08:03:18 -0000 Tom Rhodes wrote: > The following reply was made to PR docs/135983; it has been noted by GNATS. > > From: Tom Rhodes > To: Dan Naumov > Cc: bug-followup@FreeBSD.org > Subject: Re: docs/135983: "The Z File System" - title is misleading and > causes search issue > Date: Wed, 24 Jun 2009 02:58:47 -0400 > > On Tue, 23 Jun 2009 21:53:27 GMT > Dan Naumov wrote: > > > > > >Number: 135983 > > >Category: docs > > >Synopsis: "The Z File System" - title is misleading and causes search issue > > >Confidential: no > > >Severity: non-critical > > >Priority: medium > > >Responsible: freebsd-doc > > >State: open > > >Quarter: > > >Keywords: > > >Date-Required: > > >Class: doc-bug > > >Submitter-Id: current-users > > >Arrival-Date: Tue Jun 23 22:00:13 UTC 2009 > > >Closed-Date: > > >Last-Modified: > > >Originator: Dan Naumov > > >Release: 7.2-RELEASE > > >Organization: > > >Environment: > > FreeBSD atom.localdomain 7.2-RELEASE-p1 FreeBSD 7.2-RELEASE-p1 #0: Tue Jun 9 18:02:21 UTC 2009 root@amd64-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC amd64 > > >Description: > > People looking for information regarding ZFS support in FreeBSD are very likely to start by opening the handbook table of contents in their web browser, initiate their browser search function and search for "ZFS". This will result in 0 matches and the user will be left confused, thinking the handbook has no articles on the subject. > > > > Proposal: edit the following files: > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/filesystems-zfs.html > > > > and change any instances of "The Z File System" (a name which has no basis on reality) to "ZFS - Zettabyte File System". This will make the term searchable using web browser (or any other viewer) search functions allowing easier access for the user. Additionally this would decipher the ZFS acronym in a proper way with actual basis on the origin of the name. > > Actually, the term "Zettabyte" is out dated too. As for the "Z > file system" - I read that somewhere. I just can't remember, > perhaps it was the source code or a link on Sun's site or a > developer blog; trust me, I wouldn't have used it otherwise. > Searching around it appears that it's an orphan acronym > (according to: > http://opensolaris.org/os/community/zfs/faq/#whatstandfor) > > I have no issue with the changes, and may even make them > myself if I find the time; however, I just wanted to > explain where the "basis of reality" part. Thanks, > > --- > Tom Rhodes > The chapter still appears when using the "search the Handbook" link, so I feel this is not much of an issue. As a compromise though, we could probably change the title to: "The Z File System (ZFS)"