Received: by 2002:ab2:60d1:0:b0:1f7:5705:b850 with SMTP id i17csp1148825lqm; Thu, 2 May 2024 06:45:13 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCVA5WNjt5AOk/WOlu+NBMOCbpoBSKP0/otKQWuwO4bRGeROolcyggMeQHp9CPaZadZiTsm1g8A8efgUE2s6stC1r8x6q3g5hFuAFoO+oQ== X-Google-Smtp-Source: AGHT+IGGC3zi0+Pvk/JSqCCnnIDhdOVg9v+986QBIiVhxc63/nzttcM5qwN8mkegZdDw21npX4UI X-Received: by 2002:a05:6a20:a12a:b0:1af:3857:e652 with SMTP id q42-20020a056a20a12a00b001af3857e652mr7635361pzk.12.1714657513467; Thu, 02 May 2024 06:45:13 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1714657513; cv=pass; d=google.com; s=arc-20160816; b=DqUHKduwgpaRgKXqJWHBuzh2iLzsO1+KkuqB6Fglxjj3i7yJCVOhkNz+11cPOzFtUA o4kS4keSiWQfD2VAHqkl/cnmIHyrMvFwG9sb5cp7y5HCq36QGOKTThUmisTmN6mHkI7p puXSRTZjfPIt0DNq3sKhIgkxksulCIG7+SXjfezBxKSb28Xv/Pks34h8uExkGeIvAiwt 6gc5Z0bR+VxnNIK9gnP6FYlrwIjhlRze1Dmsr3ulDHKhAuCKEtaCbyJSHGM4DNyYyql/ Za0ON7qMGHKe8DtehDY6YX1j+MYXoepktw1gviZL8bFI4OyJrY2qvBpLvr/aw3m0NXen DWUw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:message-id:references:in-reply-to:subject :cc:to:from:date:mime-version:list-unsubscribe:list-subscribe :list-id:precedence:dkim-signature; bh=GqucwLVpkM9uYUrjdx6yhxAaK0zkWRsOICLbdam5+yw=; fh=Px1atfQ1Wk9JlSg8ai5DcxFcVCrMbOnyzcF1Q9IHULg=; b=EZ8tVHjCmhoh0ZU54R8xcLbu2JYzxeqdu/ovUhFP6sGEDdtjB3RBKHuuQovIKJX4AH vRvZ3zBw8R5Plt1760qzz6lp+D2qlcUKCnHU+FK8nGm0Q/1l5U2Bso5lnZX7+2R8Z0qd ctIY0PRv8JcLeuIGnnlc9TcEPiygv188EKR6xd6eRGr7Kp4/w7FpBsfgfMmkCtNlksch gYsE5Dk7rJOGx94sQJw4dQbaz9ZJ3dqQiJxSpt5g7TxoSNYZu5TMscYzCcWsNRHjZM0x gv4W/P3J7yVGeyfaKh7+dx2dbjWPmRop5beWZ541arzo1pXS8pGa64U45rPMgLusIpnr Sh2A==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kolabnow.com header.s=dkim20160331 header.b=ZyfAVcwe; arc=pass (i=1 spf=pass spfdomain=vaga.pv.it dkim=pass dkdomain=kolabnow.com); spf=pass (google.com: domain of linux-kernel+bounces-166521-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-166521-linux.lists.archive=gmail.com@vger.kernel.org" Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [139.178.88.99]) by mx.google.com with ESMTPS id s8-20020a634508000000b005f8072787e8si1059531pga.782.2024.05.02.06.45.13 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 02 May 2024 06:45:13 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-166521-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99; Authentication-Results: mx.google.com; dkim=pass header.i=@kolabnow.com header.s=dkim20160331 header.b=ZyfAVcwe; arc=pass (i=1 spf=pass spfdomain=vaga.pv.it dkim=pass dkdomain=kolabnow.com); spf=pass (google.com: domain of linux-kernel+bounces-166521-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-166521-linux.lists.archive=gmail.com@vger.kernel.org" Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id ECAF22837BA for ; Thu, 2 May 2024 13:45:12 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id A0E3213C678; Thu, 2 May 2024 13:45:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (4096-bit key) header.d=kolabnow.com header.i=@kolabnow.com header.b="ZyfAVcwe" Received: from mx.kolabnow.com (mx.kolabnow.com [212.103.80.153]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9446613C3FD; Thu, 2 May 2024 13:45:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=212.103.80.153 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1714657506; cv=none; b=fhyYlNkPtJcoW5QNFqh0KrjfLxGFA2KQpBGrlX3QCTWXzJBopmeDjQn9i6Lll2mjb2lw0SAn1lb/Y3lzB4qhUjnI2VmiW2ynudBLbVkXR0NcPj+9A8jvXAsBQLEB3qpcZjHwTIhbJUbw85zaaal6AVAZdH/h58zmrcLVvT7IL44= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1714657506; c=relaxed/simple; bh=5nO72ceCSlJCjdNyQBopUpmeyZfpJvZDxTXvgSg8kik=; h=MIME-Version:Date:From:To:Cc:Subject:In-Reply-To:References: Message-ID:Content-Type; b=DbyeCtt+gulyGV/j4hYs3kX+o+XLsmNHqsDPXco4Ivn7B4EdKmT38ABTbHgxitQTbciYZUvBgmU7lVgWjxKbXmhgZBOgkH5Xm2Y9i/C5c4zB4Z8ez2jzirCp63fLwhzVw0jdplg0KkqYOqHnuQs7sKHPIz5857gJHPQYib4pyZc= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=vaga.pv.it; spf=pass smtp.mailfrom=vaga.pv.it; dkim=pass (4096-bit key) header.d=kolabnow.com header.i=@kolabnow.com header.b=ZyfAVcwe; arc=none smtp.client-ip=212.103.80.153 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=vaga.pv.it Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=vaga.pv.it Received: from localhost (unknown [127.0.0.1]) by mx.kolabnow.com (Postfix) with ESMTP id 0D15030E3E20; Thu, 2 May 2024 15:35:54 +0200 (CEST) Authentication-Results: ext-mx-out013.mykolab.com (amavis); dkim=pass (4096-bit key) reason="pass (just generated, assumed good)" header.d=kolabnow.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kolabnow.com; h= content-transfer-encoding:content-type:content-type:message-id :references:in-reply-to:subject:subject:from:from:date:date :mime-version:received:received:received; s=dkim20160331; t= 1714656949; x=1716471350; bh=GqucwLVpkM9uYUrjdx6yhxAaK0zkWRsOICL bdam5+yw=; b=ZyfAVcweqOyVHz1I1KhhGUbevsL4Lj8R1yZ75fgeljPeuT/kP0L PbfXnuHLnsTpNL5jILBIa4Hz/3T6mhPjuhctIzhR53hmin0TLdUjL5llWgdt80wr gvmo2qqR1ce19qZQ6kds7UKVEiCYon8E2+tA4HCe5IcZvBNZRT7moIqr526jiM8K /5B+ex9yf7iPvSxxpiBkPMDimR45qgCv6H+56v78jiTexuZG+Z6wXtt+HZOFHUlD tmyrJvSg4ZZCBOICHUG832//td8TuOdjVDnFKDVea5weHoVHd8S6mtlkFzK6lTPC 1cbHVbjfNOj1tqtj6qzVAC8HGZBW6xqYb0PkboBXVOpeC4Aea3WflNtocxsg+VYT Xl++kmeOMKGabGDoA2Rr+2afZCdQZe2AMk+Ji1MnpiSCozJ44Pm9sXgnrcTkdcm4 6675mI4tTxc5zk/KzpD4TOa1qq69XonPGPQ3rxB4x7/l87vGtjMwYM/9dV1VPPII bSmd2TEKYGYA6Mo6k9e5K/TMYtA8fJCrLxlFXDUsCO0HOz2JnZ85wGYivyl4bjkl TYPxqfSDrzbH3E0wgWaDQsmkFwzOvAOR2A0NMCALbtcEts2dxOBFHe4gH9F4NZTf 7FnhLCaKbK9kHvnjDuaLu6UzU2Qc83hX+06oEfCbM/z+kQVImEInWp6Q= X-Virus-Scanned: amavis at mykolab.com X-Spam-Flag: NO X-Spam-Score: -1 X-Spam-Level: Received: from mx.kolabnow.com ([127.0.0.1]) by localhost (ext-mx-out013.mykolab.com [127.0.0.1]) (amavis, port 10024) with ESMTP id pdJCWHayAJNm; Thu, 2 May 2024 15:35:49 +0200 (CEST) Received: from int-mx011.mykolab.com (unknown [10.9.13.11]) by mx.kolabnow.com (Postfix) with ESMTPS id 44CC330E3E1B; Thu, 2 May 2024 15:35:48 +0200 (CEST) Received: from int-subm015.mykolab.com (unknown [10.9.37.15]) by int-mx011.mykolab.com (Postfix) with ESMTPS id 725FD31398C8; Thu, 2 May 2024 15:35:48 +0200 (CEST) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Date: Thu, 02 May 2024 15:35:48 +0200 From: Federico Vaga To: Jonathan Corbet Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] doc:it_IT: align Italian documentation In-Reply-To: <20240316225400.22590-1-federico.vaga@vaga.pv.it> References: <20240316225400.22590-1-federico.vaga@vaga.pv.it> Message-ID: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Hello Jonathan, I'm pinging you on this patch, just in case it got somehow lost. Have a nice day :) On 2024-03-16 23:54, Federico Vaga wrote: > Translation for the following patches > > commit 6e55b1cbf05d ("docs: try to encourage (netdev?) reviewers") > commit e49ad8530de9 ("CREDITS, MAINTAINERS, docs/process/howto: Update > man-pages' maintainer") > commit 44ac5abac86b ("Documentation/security-bugs: move from > admin-guide/ to process/") > commit 5a602de99797 ("Add .editorconfig file for basic formatting") > commit 129027b78c49 ("docs: deprecated.rst: Update an example") > commit efc0a7cfe9ec ("Docs/process/changes: Consolidate NFS-utils > update links") > commit 383f30882197 ("Docs/process/changes: Replace http:// with > https://") > commit 80fe9e51510b ("rust: upgrade to Rust 1.74.1") > commit c584476d477e ("doc: Add tar requirement to changes.rst") > commit b230235b3865 ("docs: Set minimal gtags / GNU GLOBAL version to > 6.6.5") > commit 3e893e16af55 ("docs: Raise the minimum Sphinx requirement to > 2.4.4") > commit 08ab786556ff ("rust: bindgen: upgrade to 0.65.1") > commit 185ea7676ef3 ("Documentation: coding-style: Update syntax > highlighting for code-blocks") > commit 932be49b71e7 ("Documentation: coding-style: Fix indentation in > code-blocks") > commit 5c7944ca7b13 ("coding-style: Add guidance to prefer dev_dbg") > commit c15ec3d1a287 ("Documentation: doc-guide: use '%' constant > indicator in Return: examples") > commit 329ac9af902e ("docs: submitting-patches: Discuss interleaved > replies") > commit 5382774515d4 ("(docs-next) A reworked process/index.rst") > > Signed-off-by: Federico Vaga > --- > .../it_IT/doc-guide/kernel-doc.rst | 10 +-- > .../translations/it_IT/process/2.Process.rst | 9 ++- > .../translations/it_IT/process/4.Coding.rst | 4 ++ > .../it_IT/process/7.AdvancedTopics.rst | 19 ++++++ > .../translations/it_IT/process/changes.rst | 36 ++++++---- > .../it_IT/process/coding-style.rst | 12 +++- > .../translations/it_IT/process/deprecated.rst | 2 +- > .../translations/it_IT/process/howto.rst | 6 +- > .../translations/it_IT/process/index.rst | 68 ++++++++++++++++--- > .../security-bugs.rst | 0 > .../it_IT/process/stable-kernel-rules.rst | 2 +- > .../it_IT/process/submitting-patches.rst | 27 ++++++++ > 12 files changed, 156 insertions(+), 39 deletions(-) > rename Documentation/translations/it_IT/{admin-guide => > process}/security-bugs.rst (100%) > > diff --git a/Documentation/translations/it_IT/doc-guide/kernel-doc.rst > b/Documentation/translations/it_IT/doc-guide/kernel-doc.rst > index 5cece223b46b..74057d203539 100644 > --- a/Documentation/translations/it_IT/doc-guide/kernel-doc.rst > +++ b/Documentation/translations/it_IT/doc-guide/kernel-doc.rst > @@ -180,9 +180,9 @@ Il valore di ritorno, se c'è, viene descritto in > una sezione dedicata di nome > se provate a formattare bene il vostro testo come nel seguente > esempio:: > > * Return: > - * 0 - OK > - * -EINVAL - invalid argument > - * -ENOMEM - out of memory > + * %0 - OK > + * %-EINVAL - invalid argument > + * %-ENOMEM - out of memory > > le righe verranno unite e il risultato sarà:: > > @@ -192,8 +192,8 @@ Il valore di ritorno, se c'è, viene descritto in > una sezione dedicata di nome > utilizzare una lista ReST, ad esempio:: > > * Return: > - * * 0 - OK to runtime suspend the device > - * * -EBUSY - Device should not be runtime suspended > + * * %0 - OK to runtime suspend the device > + * * %-EBUSY - Device should not be runtime suspended > > #) Se il vostro testo ha delle righe che iniziano con una frase > seguita dai > due punti, allora ognuna di queste frasi verrà considerata come > il nome > diff --git a/Documentation/translations/it_IT/process/2.Process.rst > b/Documentation/translations/it_IT/process/2.Process.rst > index 25cd00351c03..0a62c0f33faf 100644 > --- a/Documentation/translations/it_IT/process/2.Process.rst > +++ b/Documentation/translations/it_IT/process/2.Process.rst > @@ -462,9 +462,12 @@ linux-kernel: > di far domande. Molti sviluppatori possono divenire impazienti con > le > persone che chiaramente non hanno svolto i propri compiti a casa. > > -- Evitate il *top-posting* (cioè la pratica di mettere la vostra > risposta sopra > - alla frase alla quale state rispondendo). Ciò renderebbe la vostra > risposta > - difficile da leggere e genera scarsa impressione. > +- Rispondete sotto alla porzione di righe citate, così da dare un > contesto alle > + vostre risposte, e quindi renderle più leggibili (in altre parole, > evitate di > + rispondere in cima, ovvero prima del testo citato). Per maggiori > dettagli > + leggete > :ref:`Documentation/translations/it_IT/process/submitting-patches.rst > + `. > + > > - Chiedete nella lista di discussione corretta. Linux-kernel può > essere un > punto di incontro generale, ma non è il miglior posto dove trovare > diff --git a/Documentation/translations/it_IT/process/4.Coding.rst > b/Documentation/translations/it_IT/process/4.Coding.rst > index 54fd255b77d0..ec874a8dfb9d 100644 > --- a/Documentation/translations/it_IT/process/4.Coding.rst > +++ b/Documentation/translations/it_IT/process/4.Coding.rst > @@ -72,6 +72,10 @@ compiti del genere. Consultate il file > :ref:`Documentation/translations/it_IT/process/clang-format.rst > ` > per maggiori dettagli > > +Se utilizzate un programma compatibile con EditorConfig, allora alcune > +configurazioni basilari come l'indentazione e la fine delle righe > verranno > +applicate automaticamente. Per maggiori informazioni consultate la > pagina: > +https://editorconfig.org/ > > Livelli di astrazione > ********************* > diff --git > a/Documentation/translations/it_IT/process/7.AdvancedTopics.rst > b/Documentation/translations/it_IT/process/7.AdvancedTopics.rst > index dffd813a0910..a83fcfe18024 100644 > --- a/Documentation/translations/it_IT/process/7.AdvancedTopics.rst > +++ b/Documentation/translations/it_IT/process/7.AdvancedTopics.rst > @@ -160,6 +160,8 @@ preparerà una richiesta nel modo in cui gli altri > sviluppatori se l'aspettano, > e verificherà che vi siate ricordati di pubblicare quelle patch su un > server pubblico. > > +.. _development_advancedtopics_reviews_it: > + > Revisionare le patch > -------------------- > > @@ -180,6 +182,13 @@ i commenti come domande e non come critiche. > Chiedere "Come viene rilasciato > il *lock* in questo percorso?" funziona sempre molto meglio che > "qui la sincronizzazione è sbagliata". > > +In caso di disaccordi, può essere utile chiedere una terza opinione. > Se dopo > +pochi scambi la discussione raggiunge un punto morto, allora chiedete > ai > +manutentori o altri revisori di partecipare esprimendo la loro > opinione. Spesso > +vige un silenzio assenso per cui gli altri revisori non intervengono > se non gli > +viene richiesto esplicitamente. L'opinione di più persone avrà > sicuramente un > +peso maggiore. > + > Diversi sviluppatori revisioneranno il codice con diversi punti di > vista. > Alcuni potrebbero concentrarsi principalmente sullo stile del codice e > se > alcune linee hanno degli spazio bianchi di troppo. Altri si > chiederanno > @@ -189,3 +198,13 @@ l'uso eccessivo di *stack*, problemi di > sicurezza, duplicazione del codice > in altri contesti, documentazione, effetti negativi sulle prestazioni, > cambi > all'ABI dello spazio utente, eccetera. Qualunque tipo di revisione è > ben > accetta e di valore, se porta ad avere un codice migliore nel kernel. > + > +Non esistono requisiti particolarmente stringenti per l'uso di > etichette come > +``Reviewd-by``. Tuttavia, perché la revisione sia efficace ci si > aspetta un > +qualche tipo di messaggio che dica "ho verificato A, B e C nel codice > che è > +appena stato inviato e mi sembra tutto in ordine". Inoltre, questo > permette ai > +manutentori di prendere conoscenza circa una revisione avvenuta per > davvero. > + > +Per finire, la revisione delle patch può diventare un processo > negativo, troppo > +focalizzato sulla ricerca dei problemi. Provate a fare qualche > complimento di > +tanto in tanto, specialmente con i nuovi arrivati. > diff --git a/Documentation/translations/it_IT/process/changes.rst > b/Documentation/translations/it_IT/process/changes.rst > index f37c53f8b524..ade695a7de19 100644 > --- a/Documentation/translations/it_IT/process/changes.rst > +++ b/Documentation/translations/it_IT/process/changes.rst > @@ -34,13 +34,15 @@ PC Card, per esempio, probabilmente non dovreste > preoccuparvi di pcmciautils. > ====================== ================= > ======================================== > GNU C 5.1 gcc --version > Clang/LLVM (optional) 11.0.0 clang --version > +Rust (opzionale) 1.74.1 rustc --version > +bindgen (opzionale) 0.65.1 bindgen --version > GNU make 3.81 make --version > bash 4.2 bash --version > binutils 2.25 ld -v > flex 2.5.35 flex --version > bison 2.0 bison --version > pahole 1.16 pahole --version > -util-linux 2.10o fdformat --version > +util-linux 2.10o mount --version > kmod 13 depmod -V > e2fsprogs 1.41.4 e2fsck -V > jfsutils 1.1.3 fsck.jfs -V > @@ -59,8 +61,10 @@ mcelog 0.6 mcelog > --version > iptables 1.4.2 iptables -V > openssl & libcrypto 1.0.0 openssl version > bc 1.06.95 bc --version > -Sphinx\ [#f1]_ 1.7 sphinx-build --version > +Sphinx\ [#f1]_ 2.4.4 sphinx-build --version > cpio any cpio --version > +GNU tar 1.28 tar --version > +gtags (opzionale) 6.6.5 gtags --version > ====================== ================= > ======================================== > > .. [#f1] Sphinx è necessario solo per produrre la documentazione del > Kernel > @@ -151,6 +155,18 @@ Se la firma dei moduli è abilitata, allora vi > servirà openssl per compilare il > kernel 3.7 e successivi. Vi serviranno anche i pacchetti di sviluppo > di > openssl per compilare il kernel 4.3 o successivi. > > +Tar > +--- > + > +GNU Tar è necessario per accedere ai file d'intestazione del kernel > usando sysfs > +(CONFIG_IKHEADERS) > + > +gtags / GNU GLOBAL (opzionale) > +------------------------------ > + > +Il programma GNU GLOBAL versione 6.6.5, o successiva, è necessario > quando si > +vuole eseguire ``make gtags`` e generare i relativi indici. > Internamente si fa > +uso del parametro gtags ``-C (--directory)`` che compare in questa > versione. > > Strumenti di sistema > ******************** > @@ -434,7 +450,7 @@ E2fsprogs > JFSutils > -------- > > -- > +- > > Reiserfsprogs > ------------- > @@ -455,7 +471,7 @@ Pcmciautils > Quota-tools > ----------- > > -- > +- > > > Microcodice Intel P6 > @@ -476,7 +492,7 @@ FUSE > mcelog > ------ > > -- > +- > > cpio > ---- > @@ -497,7 +513,8 @@ PPP > NFS-utils > --------- > > -- > +- > +- > > Iptables > -------- > @@ -512,12 +529,7 @@ Ip-route2 > OProfile > -------- > > -- > - > -NFS-Utils > ---------- > - > -- > +- > > Documentazione del kernel > ************************* > diff --git a/Documentation/translations/it_IT/process/coding-style.rst > b/Documentation/translations/it_IT/process/coding-style.rst > index 284a75ac19f8..a4b9f44081da 100644 > --- a/Documentation/translations/it_IT/process/coding-style.rst > +++ b/Documentation/translations/it_IT/process/coding-style.rst > @@ -214,7 +214,7 @@ Non usate inutilmente le graffe dove una singola > espressione è sufficiente. > > e > > -.. code-block:: none > +.. code-block:: c > > if (condition) > do_this(); > @@ -652,7 +652,7 @@ Quindi, potete sbarazzarvi di GNU emacs, o > riconfigurarlo con valori più > sensati. Per fare quest'ultima cosa, potete appiccicare il codice che > segue nel vostro file .emacs: > > -.. code-block:: none > +.. code-block:: elisp > > (defun c-lineup-arglist-tabs-only (ignored) > "Line up argument lists by tabs, not spaces" > @@ -728,6 +728,10 @@ il testo e altre cose simili. > Per maggiori dettagli, consultate il file > :ref:`Documentation/translations/it_IT/process/clang-format.rst > `. > > +Se utilizzate un programma compatibile con EditorConfig, allora alcune > +configurazioni basilari come l'indentazione e la fine delle righe > verranno > +applicate automaticamente. Per maggiori informazioni consultate la > pagina: > +https://editorconfig.org/ > > 10) File di configurazione Kconfig > ---------------------------------- > @@ -898,7 +902,9 @@ usare per assicurarvi che i messaggi vengano > associati correttamente ai > dispositivi e ai driver, e che siano etichettati correttamente: > dev_err(), > dev_warn(), dev_info(), e così via. Per messaggi che non sono > associati ad > alcun dispositivo, definisce pr_info(), pr_warn(), > pr_err(), > -eccetera. > +eccetera. Quando tutto funziona correttamente, non dovrebbero esserci > stampe, > +per cui preferite dev_dbg/pr_debug a meno che non sia qualcosa di > sbagliato > +da segnalare. > > Tirar fuori un buon messaggio di debug può essere una vera sfida; e > quando > l'avete può essere d'enorme aiuto per risolvere problemi da remoto. > diff --git a/Documentation/translations/it_IT/process/deprecated.rst > b/Documentation/translations/it_IT/process/deprecated.rst > index ba0ed7dc154c..d4ab76e9be49 100644 > --- a/Documentation/translations/it_IT/process/deprecated.rst > +++ b/Documentation/translations/it_IT/process/deprecated.rst > @@ -86,7 +86,7 @@ da kcalloc(). > Se questo tipo di allocatore non è disponibile, allora dovrebbero > essere usate > le funzioni del tipo *saturate-on-overflow*:: > > - bar = vmalloc(array_size(count, size)); > + bar = dma_alloc_coherent(dev, array_size(count, size), &dma, > GFP_KERNEL); > > Un altro tipico caso da evitare è quello di calcolare la dimensione di > una > struttura seguita da un vettore di altre strutture, come nel seguente > caso:: > diff --git a/Documentation/translations/it_IT/process/howto.rst > b/Documentation/translations/it_IT/process/howto.rst > index 052f1b3610cb..090941a0a898 100644 > --- a/Documentation/translations/it_IT/process/howto.rst > +++ b/Documentation/translations/it_IT/process/howto.rst > @@ -85,8 +85,8 @@ relativi file di documentatione che spiegano come > usarele. > Quando un cambiamento del kernel genera anche un cambiamento > nell'interfaccia > con lo spazio utente, è raccomandabile che inviate una notifica o una > correzione alle pagine *man* spiegando tale modifica agli > amministratori di > -queste pagine all'indirizzo mtk.manpages@gmail.com, aggiungendo > -in CC la lista linux-api@vger.kernel.org. > +queste pagine all'indirizzo alx@kernel.org, aggiungendo in CC la > +lista linux-api@vger.kernel.org. > > Di seguito una lista di file che sono presenti nei sorgente del kernel > e che > è richiesto che voi leggiate: > @@ -144,7 +144,7 @@ Di seguito una lista di file che sono presenti nei > sorgente del kernel e che > dello sviluppo di Linux ed è molto importante per le persone che > arrivano > da esperienze con altri Sistemi Operativi. > > - > :ref:`Documentation/translations/it_IT/admin-guide/security-bugs.rst > ` > + :ref:`Documentation/translations/it_IT/process/security-bugs.rst > ` > Se ritenete di aver trovato un problema di sicurezza nel kernel > Linux, > seguite i passaggi scritti in questo documento per notificarlo > agli > sviluppatori del kernel, ed aiutare la risoluzione del problema. > diff --git a/Documentation/translations/it_IT/process/index.rst > b/Documentation/translations/it_IT/process/index.rst > index cd7977905fb8..73c643dcc541 100644 > --- a/Documentation/translations/it_IT/process/index.rst > +++ b/Documentation/translations/it_IT/process/index.rst > @@ -21,19 +21,75 @@ l'accettazione delle vostre modifiche con il minimo > sforzo. > > Di seguito le guide che ogni sviluppatore dovrebbe leggere. > > +Introduzione al funzionamento dello sviluppo del kernel > +------------------------------------------------------- > + > +Innanzitutto, leggete questi documenti che vi aiuteranno ad entrare > nella > +comunità del kernel. > + > .. toctree:: > :maxdepth: 1 > > howto > - code-of-conduct > development-process > submitting-patches > + submit-checklist > + > +Strumenti e guide tecniche per gli sviluppatori del kernel > +---------------------------------------------------------- > + > +Quella che segue è una raccolta di documenti che uno sviluppatore del > kernel > +Linux dovrebbe conoscere. > + > +.. toctree:: > + :maxdepth: 1 > + > + changes > programming-language > coding-style > maintainer-pgp-guide > email-clients > + applying-patches > + adding-syscalls > + volatile-considered-harmful > + botching-up-ioctls > + > +Politiche e dichiarazioni degli sviluppatori > +-------------------------------------------- > + > +Quelle che seguono rappresentano le regole che cerchiamo di seguire > all'interno > +della comunità del kernel (e oltre). > + > +.. toctree:: > + :maxdepth: 1 > + > + code-of-conduct > kernel-enforcement-statement > kernel-driver-statement > + stable-api-nonsense > + stable-kernel-rules > + management-style > + > +Gestire i bachi > +--------------- > + > +I bachi sono parte della nostra vita; dunque è importante che vengano > trattati > +con riguardo. I documenti che seguono descrivono le nostre politiche > riguardo al > +trattamento di alcune classi particolari di bachi: le regressioni e i > problemi > +di sicurezza. > + > +Informazioni per i manutentori > +------------------------------ > + > +Come trovare le persone che accetteranno le vostre modifiche. > + > +.. toctree:: > + :maxdepth: 1 > + > + maintainers > + > +Altri documenti > +--------------- > > Poi ci sono altre guide sulla comunità che sono di interesse per molti > degli sviluppatori: > @@ -41,13 +97,7 @@ degli sviluppatori: > .. toctree:: > :maxdepth: 1 > > - changes > - stable-api-nonsense > - management-style > - stable-kernel-rules > - submit-checklist > kernel-docs > - maintainers > > Ed infine, qui ci sono alcune guide più tecniche che son state messe > qua solo > perché non si è trovato un posto migliore. > @@ -55,11 +105,7 @@ perché non si è trovato un posto migliore. > .. toctree:: > :maxdepth: 1 > > - applying-patches > - adding-syscalls > magic-number > - volatile-considered-harmful > - botching-up-ioctls > clang-format > ../riscv/patch-acceptance > > diff --git > a/Documentation/translations/it_IT/admin-guide/security-bugs.rst > b/Documentation/translations/it_IT/process/security-bugs.rst > similarity index 100% > rename from > Documentation/translations/it_IT/admin-guide/security-bugs.rst > rename to Documentation/translations/it_IT/process/security-bugs.rst > diff --git > a/Documentation/translations/it_IT/process/stable-kernel-rules.rst > b/Documentation/translations/it_IT/process/stable-kernel-rules.rst > index 248bf1e4b171..a2577a806a18 100644 > --- a/Documentation/translations/it_IT/process/stable-kernel-rules.rst > +++ b/Documentation/translations/it_IT/process/stable-kernel-rules.rst > @@ -44,7 +44,7 @@ Procedura per sottomettere patch per i sorgenti > -stable > .. note:: > Una patch di sicurezza non dovrebbe essere gestita (solamente) dal > processo > di revisione -stable, ma dovrebbe seguire le procedure descritte in > - > :ref:`Documentation/translations/it_IT/admin-guide/security-bugs.rst > `. > + :ref:`Documentation/translations/it_IT/process/security-bugs.rst > `. > > Per tutte le altre sottomissioni, scegliere una delle seguenti > procedure > > ------------------------------------------------------------------------ > diff --git > a/Documentation/translations/it_IT/process/submitting-patches.rst > b/Documentation/translations/it_IT/process/submitting-patches.rst > index f91c8092844f..4c6a276bdc08 100644 > --- a/Documentation/translations/it_IT/process/submitting-patches.rst > +++ b/Documentation/translations/it_IT/process/submitting-patches.rst > @@ -349,6 +349,33 @@ Leggete > Documentation/translations/it_IT/process/email-clients.rst per > le raccomandazioni sui programmi di posta elettronica e l'etichetta da > usare > sulle liste di discussione. > > +.. _it_interleaved_replies: > + > +Rispondere alle email in riga e riducendo la citazioni > +------------------------------------------------------ > + > +Nelle discussioni riguardo allo sviluppo del kernel viene fortemente > scoraggiato > +l'uso di risposte in cima ai messaggi di posta elettronica. Rispondere > in riga > +rende le conversazioni molto più scorrevoli. Maggiori dettagli possono > essere > +trovati qui: > https://en.wikipedia.org/wiki/Posting_style#Interleaved_style > + > +Come spesso citato nelle liste di discussione:: > + > + R: http://en.wikipedia.org/wiki/Top_post > + D: Dove posso trovare informazioni riguardo alle "risposte in cima"? > + R: Perché incasina il normale ordine con cui si legge un testo. > + D: Perché è così terribile rispondere in cima? > + R: Risposte in cima. > + Q: Qual è la cosa più fastidiosa nei messaggi di posta elettronica? > + > +Allo stesso modo, per favore eliminate tutte le citazioni non > necessarie per la > +vostra risposta. Questo permette di trovare più facilmente le > risposte, e > +permette di risparmiare tempo e spazio. Per maggiori dettagli: > +http://daringfireball.net/2007/07/on_top :: > + > + R: No. > + D: Dovrei includere un blocco di citazione dopo la mia risposta? > + > .. _it_resend_reminders: > > Non scoraggiatevi - o impazientitevi -- Federico Vaga http://www.federicovaga.it/