From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wi0-f175.google.com (mail-wi0-f175.google.com [209.85.212.175]) by dpdk.org (Postfix) with ESMTP id CE97D2C7A for ; Thu, 12 Feb 2015 10:29:40 +0100 (CET) Received: by mail-wi0-f175.google.com with SMTP id r20so2666624wiv.2 for ; Thu, 12 Feb 2015 01:29:40 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:organization :user-agent:in-reply-to:references:mime-version :content-transfer-encoding:content-type; bh=yfW7FP1Q0BjECZE01RUWt9rBc6jzTnwhv7jAi3JZ3AU=; b=Mz1M00A+e65jyp4S/KcZ0oNhsIPY5QNVDeirlS8P+mdQou8MF+8jMcz8ZkQLptxlTU XPBJhl4SlOqfLEuCEYX1hi7BW1kdDHXGyK//Lbf1L4CmhV9OIzcTi2Ii7YHlWDALngaF AvN56sMYG80J3czFKqZYgBiOcaw19BeYKMFSg04tq82ohLt4Sk/1VgCpGj2CGijHTK8r NmsQi340CbsOR2gf4/ou1rjdOi9PwSKJFpccgqvWd2rkrQy50Foa5R5r2i2nkn+QjtAr 80H3V8DiJYH3EGDZBiQOsY4aInbxXXhf3asZHqjHs2E9II1WA1eJpgtFNuHl7FvZvqzc PKOA== X-Gm-Message-State: ALoCoQnkD4yAjpRxvNh7WA68mHBWibPWC28D75TebtTXbvZvixGi/MRwMgEMGeFUtkwkqgxxWsLv X-Received: by 10.180.21.210 with SMTP id x18mr4193551wie.78.1423733380605; Thu, 12 Feb 2015 01:29:40 -0800 (PST) Received: from xps13.localnet (136-92-190-109.dsl.ovh.fr. [109.190.92.136]) by mx.google.com with ESMTPSA id pp10sm4849835wjc.31.2015.02.12.01.29.39 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 12 Feb 2015 01:29:39 -0800 (PST) From: Thomas Monjalon To: Matthew Hall Date: Thu, 12 Feb 2015 10:29:12 +0100 Message-ID: <25886713.7gVMi5Gd1P@xps13> Organization: 6WIND User-Agent: KMail/4.14.4 (Linux/3.18.4-1-ARCH; KDE/4.14.4; x86_64; ; ) In-Reply-To: <20150212070635.GA31227@mhcomputing.net> References: <20150212070635.GA31227@mhcomputing.net> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Cc: dev@dpdk.org Subject: Re: [dpdk-dev] Previous DPDK version API documentation for app developers X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 12 Feb 2015 09:29:41 -0000 Hi Matthew, 2015-02-11 23:06, Matthew Hall: > Hi all, > > I ran into a funny situation today with the API documentation. > > For stability until I can get my app mostly working, I was using DPDK 1.7.X, > so I could concentrate on making the app reliable. But the DPDK website only > has the API docs for DPDK 1.8.X / HEAD. Yes, previous policy was to publish only the doc of latest release. But starting with 1.8 (first release including guides), we'll keep every versions. Example: http://dpdk.org/doc/api http://dpdk.org/doc/api-1.8 The web page will be modified to list different versions. > I was wondering if we could have copies of the most recent few versions in the > site, and some scripts or steps to regenerate locally so you can get the > matching version in the local machine. Yes you can: make doc For doxygen API only: make doc-api-html For sphinx only: doc-guides-html. > This would also help me to do some suppoert things for our community, like > making small patches to fix parts of the docs with typos / formatting bugs. > > With the steps how to generate them right, I could fix docs bugs in the > sources and make sure the docs read right afterward for others. Thanks