From mboxrd@z Thu Jan 1 00:00:00 1970 From: Pavel Machek Subject: Re: [PATCH v2 34/37] docs: fix locations of several documents that got moved Date: Wed, 2 Nov 2016 10:31:54 +0100 Message-ID: <20161102093154.GC23350@amd> References: <28c1f5d3867174a7017e3f3d9e9e4ebb096ceed8.1476801354.git.mchehab@s-opensource.com> <20161019103442.GD1461@amd> <20161019115918.1162d16e@vento.lan> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============7680369000982517778==" Return-path: In-Reply-To: <20161019115918.1162d16e@vento.lan> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: virtualization-bounces@lists.linux-foundation.org Errors-To: virtualization-bounces@lists.linux-foundation.org To: Mauro Carvalho Chehab Cc: Nicolas Pitre , Linus Walleij , Jaroslav Kysela , Chris Metcalf , Peter Loeffler , Finn Thain , Yaowei Bai , Jakub Wilk , linux-acpi@vger.kernel.org, Geert Uytterhoeven , Guenter Roeck , Petr Mladek , Jean Delvare , linux-pm@vger.kernel.org, Alexander Viro , Andy Lutomirski , Thomas Gleixner , Karsten Keil , Jiri Kosina , "seokhoon.yoon" , Li Zefan , Ryan Swan , Joe Perches , Andrew Morton , Mark List-Id: alsa-devel@alsa-project.org --===============7680369000982517778== Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="+nBD6E3TurpgldQp" Content-Disposition: inline --+nBD6E3TurpgldQp Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi! > > Dunno, but kernel-parameters.txt was already quite long... for a file > > that is referenced quite often. Adding admin-guide/ into the path does > > not really help. >=20 > The big string name starts with Documentation/ :) There are some discussi= ons=20 > about changing it to doc/ (or docs/). Also, as you said, kernel-parameters > is already a big name. Perhaps we could use, instead, > > "kernel-parms". cmdline? > If we rename kernel-parameters.rst to kernel-parms.rst, plus the doc/ ren= ame, > then the string size will actually reduce: >=20 > - (see Documentation/kernel-parameters.txt), the minimum possible > + (see doc/admin-guide/kernel-parms.rst), the minimum possible >=20 > > Maybe admin-guide should go directly into Documentation/ , as that's > > what our users are interested in? >=20 > There are several problems if we keep them at Documentation/ dir: >=20 > - We'll end by mixing documents already converted to ReST with documents > not converted yet; >=20 > - A rename is needed anyway, as Sphinx only accepts ReST files that end > with the extension(s) defined at Documentation/conf.py (currently, > .rst); >=20 > - A partial documentation build is made by sub-directory. If we put > files under /Documentation, there's no way to build just one > book. Well, documentation is primarily for users. I'm sure tools can adapt... > > Plus, I'm not sure how many developers will figure out that process/ > > is what describes kernel patch submission process. We have processes > > in the kernel, after all... >=20 > Do you have a better idea? development/ ? Best regards, Pavel --=20 (english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blo= g.html --+nBD6E3TurpgldQp Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iEYEARECAAYFAlgZsooACgkQMOfwapXb+vKDEwCdEmlwjrrTY1HV6PoP/Pyie4I+ oBMAnjN0WHtyXtQBydl/7WLL5tES6tZi =EDvv -----END PGP SIGNATURE----- --+nBD6E3TurpgldQp-- --===============7680369000982517778== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Virtualization mailing list Virtualization@lists.linux-foundation.org https://lists.linuxfoundation.org/mailman/listinfo/virtualization --===============7680369000982517778==-- From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Sender: rtc-linux@googlegroups.com Received: from atrey.karlin.mff.cuni.cz (atrey.karlin.mff.cuni.cz. [195.113.26.193]) by gmr-mx.google.com with ESMTPS id h23si892585wmi.1.2016.11.02.02.31.55 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 02 Nov 2016 02:31:55 -0700 (PDT) Date: Wed, 2 Nov 2016 10:31:54 +0100 From: Pavel Machek To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Jonathan Corbet , "Rafael J. Wysocki" , Len Brown , Jens Axboe , Alessandro Zummo , Alexandre Belloni , Rob Herring , Mark Rutland , Jean Delvare , Guenter Roeck , Karsten Keil , Mauro Carvalho Chehab , Steffen Klassert , Greg Kroah-Hartman , Johannes Berg , Jaroslav Kysela , Takashi Iwai , Paolo Bonzini , Radim =?utf-8?B?S3LEjW3DocWZ?= , Wim Van Sebroeck , Thomas Gleixner , Ingo Molnar , "H. Peter Anvin" , x86@kernel.org, Harry Wei , Tejun Heo , Harald Welte , Wolfgang Grandegger , Marc Kleine-Budde , Dan Williams , Martyn Welch , Manohar Vanga , Tomi Valkeinen , "Michael S. Tsirkin" , Alexander Viro , Anton Vorontsov , Colin Cross , Kees Cook , Tony Luck , Andy Whitcroft , Joe Perches , Shuah Khan , Diego Viola , =?iso-8859-1?B?2Hl2aW5kIEEu?= Holm , James Bottomley , Linus Walleij , Andrew Morton , "Paul E. McKenney" , Greg Hackmann , Manuel =?iso-8859-1?Q?P=E9gouri=E9-Gonnard?= , Jiri Kosina , Li Zefan , Yuan Sun , Haosdent Huang , Li RongQing , Masanari Iida , "David S. Miller" , SeongJae Park , Minchan Kim , Markus Heiser , Laurent Pinchart , Askar Safin , Thomas Gardner , Peter Loeffler , Philippe Loctaux , Doug Smythies , Chris Metcalf , Jakub Wilk , "Martin K. Petersen" , Finn Thain , Hannes Reinicke , Geert Uytterhoeven , Arnaldo Carvalho de Melo , Borislav Petkov , Christian Borntraeger , Andy Lutomirski , Daniel Bristot de Oliveira , Ben Hutchings , Hidehiro Kawai , "seokhoon.yoon" , Egor Uleyskiy , Ryan Swan , Rasmus Villemoes , Ulf Hansson , Tomeu Vizoso , Andy Shevchenko , Sudip Mukherjee , Oliver Neukum , Arnd Bergmann , Johannes Weiner , Thomas Garnier , Ard Biesheuvel , Petr Mladek , Nicolas Pitre , Prarit Bhargava , Yang Shi , Yaowei Bai , Andrey Ryabinin , Josh Poimboeuf , Nikolay Aleksandrov , Dmitry Vyukov , Darren Hart , Wei Jiangang , linux-acpi@vger.kernel.org, rtc-linux@googlegroups.com, devicetree@vger.kernel.org, linux-hwmon@vger.kernel.org, netdev@vger.kernel.org, linux-pm@vger.kernel.org, stable@vger.kernel.org, linux-wireless@vger.kernel.org, alsa-devel@alsa-project.org, kvm@vger.kernel.org, linux-watchdog@vger.kernel.org, linux-kernel@zh-kernel.org, linux-ide@vger.kernel.org, linux-can@vger.kernel.org, linux-nvdimm@lists.01.org, devel@driverdev.osuosl.org, linux-fbdev@vger.kernel.org, virtualization@lists.linux-foundation.org, linux-fsdevel@vger.kernel.org, linux-kselftest@vger.kernel.org Subject: [rtc-linux] Re: [PATCH v2 34/37] docs: fix locations of several documents that got moved Message-ID: <20161102093154.GC23350@amd> References: <28c1f5d3867174a7017e3f3d9e9e4ebb096ceed8.1476801354.git.mchehab@s-opensource.com> <20161019103442.GD1461@amd> <20161019115918.1162d16e@vento.lan> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="+nBD6E3TurpgldQp" In-Reply-To: <20161019115918.1162d16e@vento.lan> Reply-To: rtc-linux@googlegroups.com List-ID: List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , --+nBD6E3TurpgldQp Content-Type: text/plain; charset=UTF-8 Content-Disposition: inline Hi! > > Dunno, but kernel-parameters.txt was already quite long... for a file > > that is referenced quite often. Adding admin-guide/ into the path does > > not really help. > > The big string name starts with Documentation/ :) There are some discussions > about changing it to doc/ (or docs/). Also, as you said, kernel-parameters > is already a big name. Perhaps we could use, instead, > > "kernel-parms". cmdline? > If we rename kernel-parameters.rst to kernel-parms.rst, plus the doc/ rename, > then the string size will actually reduce: > > - (see Documentation/kernel-parameters.txt), the minimum possible > + (see doc/admin-guide/kernel-parms.rst), the minimum possible > > > Maybe admin-guide should go directly into Documentation/ , as that's > > what our users are interested in? > > There are several problems if we keep them at Documentation/ dir: > > - We'll end by mixing documents already converted to ReST with documents > not converted yet; > > - A rename is needed anyway, as Sphinx only accepts ReST files that end > with the extension(s) defined at Documentation/conf.py (currently, > .rst); > > - A partial documentation build is made by sub-directory. If we put > files under /Documentation, there's no way to build just one > book. Well, documentation is primarily for users. I'm sure tools can adapt... > > Plus, I'm not sure how many developers will figure out that process/ > > is what describes kernel patch submission process. We have processes > > in the kernel, after all... > > Do you have a better idea? development/ ? Best regards, Pavel -- (english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html -- You received this message because you are subscribed to "rtc-linux". Membership options at http://groups.google.com/group/rtc-linux . Please read http://groups.google.com/group/rtc-linux/web/checklist before submitting a driver. --- You received this message because you are subscribed to the Google Groups "rtc-linux" group. To unsubscribe from this group and stop receiving emails from it, send an email to rtc-linux+unsubscribe@googlegroups.com. For more options, visit https://groups.google.com/d/optout. --+nBD6E3TurpgldQp Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iEYEARECAAYFAlgZsooACgkQMOfwapXb+vKDEwCdEmlwjrrTY1HV6PoP/Pyie4I+ oBMAnjN0WHtyXtQBydl/7WLL5tES6tZi =EDvv -----END PGP SIGNATURE----- --+nBD6E3TurpgldQp-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: Pavel Machek Subject: Re: [PATCH v2 34/37] docs: fix locations of several documents that got moved Date: Wed, 2 Nov 2016 10:31:54 +0100 Message-ID: <20161102093154.GC23350@amd> References: <28c1f5d3867174a7017e3f3d9e9e4ebb096ceed8.1476801354.git.mchehab@s-opensource.com> <20161019103442.GD1461@amd> <20161019115918.1162d16e@vento.lan> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============7680369000982517778==" Cc: Nicolas Pitre , Linus Walleij , Jaroslav Kysela , Chris Metcalf , Peter Loeffler , Finn Thain , Yaowei Bai , Jakub Wilk , linux-acpi@vger.kernel.org, Geert Uytterhoeven , Guenter Roeck , Petr Mladek , Jean Delvare , linux-pm@vger.kernel.org, Alexander Viro , Andy Lutomirski , Thomas Gleixner , Karsten Keil , Jiri Kosina , "seokhoon.yoon" , Li Zefan , Ryan Swan , Joe Perches , Andrew Morton , Mark Rutland To: Mauro Carvalho Chehab Return-path: In-Reply-To: <20161019115918.1162d16e@vento.lan> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: virtualization-bounces@lists.linux-foundation.org Errors-To: virtualization-bounces@lists.linux-foundation.org List-Id: kvm.vger.kernel.org --===============7680369000982517778== Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="+nBD6E3TurpgldQp" Content-Disposition: inline --+nBD6E3TurpgldQp Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi! > > Dunno, but kernel-parameters.txt was already quite long... for a file > > that is referenced quite often. Adding admin-guide/ into the path does > > not really help. >=20 > The big string name starts with Documentation/ :) There are some discussi= ons=20 > about changing it to doc/ (or docs/). Also, as you said, kernel-parameters > is already a big name. Perhaps we could use, instead, > > "kernel-parms". cmdline? > If we rename kernel-parameters.rst to kernel-parms.rst, plus the doc/ ren= ame, > then the string size will actually reduce: >=20 > - (see Documentation/kernel-parameters.txt), the minimum possible > + (see doc/admin-guide/kernel-parms.rst), the minimum possible >=20 > > Maybe admin-guide should go directly into Documentation/ , as that's > > what our users are interested in? >=20 > There are several problems if we keep them at Documentation/ dir: >=20 > - We'll end by mixing documents already converted to ReST with documents > not converted yet; >=20 > - A rename is needed anyway, as Sphinx only accepts ReST files that end > with the extension(s) defined at Documentation/conf.py (currently, > .rst); >=20 > - A partial documentation build is made by sub-directory. If we put > files under /Documentation, there's no way to build just one > book. Well, documentation is primarily for users. I'm sure tools can adapt... > > Plus, I'm not sure how many developers will figure out that process/ > > is what describes kernel patch submission process. We have processes > > in the kernel, after all... >=20 > Do you have a better idea? development/ ? Best regards, Pavel --=20 (english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blo= g.html --+nBD6E3TurpgldQp Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iEYEARECAAYFAlgZsooACgkQMOfwapXb+vKDEwCdEmlwjrrTY1HV6PoP/Pyie4I+ oBMAnjN0WHtyXtQBydl/7WLL5tES6tZi =EDvv -----END PGP SIGNATURE----- --+nBD6E3TurpgldQp-- --===============7680369000982517778== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Virtualization mailing list Virtualization@lists.linux-foundation.org https://lists.linuxfoundation.org/mailman/listinfo/virtualization --===============7680369000982517778==--