From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7001018444897320960 X-Received: by 2002:ac2:5fca:: with SMTP id q10mr5961829lfg.235.1630051642944; Fri, 27 Aug 2021 01:07:22 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a2e:9109:: with SMTP id m9ls1664075ljg.2.gmail; Fri, 27 Aug 2021 01:07:21 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwxD2fzztzJFv4wbhAZiETsSPg64R2p5nlkHhDQ1XiA3lJFjrOOdu36sppfr+lT1Kv0LoTR X-Received: by 2002:a2e:99c8:: with SMTP id l8mr6814171ljj.178.1630051641534; Fri, 27 Aug 2021 01:07:21 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1630051641; cv=none; d=google.com; s=arc-20160816; b=rbVS5bXLPB+cSnPJFWVoOj26ItCyrawzevO6RvZDUD0l4BRdKenN/tWjf4UiEQo/zz l9jk2kzEXyU+nZtk0oyxtK7c0ZPx2V9mTXIWZIeBrokk+hSxgeWMoV/LSjrWDrqzdwn1 QW8kCo/QWV79ODIxqOm7HEon5qUIGQ6mqxYOFGMRiKTSt0lXOQnUaPRV2wRlGUu/9Qnn terGFUK7z4bXsNc1JQ51IDFB53nN9LIFCbXFDqzP6COTEY8sgNDljvo+2WI+EJFafPl3 Ct/HZsCza6toU89ztarrdsZX6bVgR0Ndg/D7rQk5rRkv7SKG74Ua3Tt/XmecpSrFjssr +Z+w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from; bh=VnF/pKbLPTQtqPkWAy4Rmm39Ex0PMVybswCVGcFb860=; b=v0Iz+C8LqUy+cM0s8sFBcz2S9TK3EXVbTrpotHoKVsaYHRo18xjx20X0Y71eLqc7rz TK0g7GmkswYaTGTb/gAc/UmI0Lcy5n2kI3rNeWsVB5ke07w7NGNIqMwUb0+ffz6GuPGD 7ALfoeCqsqEWKSgnnPE+5g1EMdZuI7GDPOQZXEsiMKEneJxqSvBpiWpxOW88Fdyfo4C7 d1e/2CZJgASYgEYtsmF2bn87huwRmeWz/dqNXOFjhjEi9iV9Bfuw/FUMd2G2zBBUx/LI yIoKBIZM4Jkix183PBpT3tziy8MnNO5+4DzrtnDktkMU1R2YzXzVVd4t53fprpgDBEpg OWaQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id h8si257036lfu.0.2021.08.27.01.07.21 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Fri, 27 Aug 2021 01:07:21 -0700 (PDT) Received-SPF: pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Received: from baighyz.m.ilbers.de (host-80-81-17-52.static.customer.m-online.net [80.81.17.52]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id 17R871RP019101 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 27 Aug 2021 10:07:16 +0200 From: Uladzimir Bely To: isar-users@googlegroups.com Subject: [RFC 3/3] doc: Add a section on gbp-compatible packages Date: Fri, 27 Aug 2021 10:07:01 +0200 Message-Id: <20210827080701.5099-4-ubely@ilbers.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20210827080701.5099-1-ubely@ilbers.de> References: <20210827080701.5099-1-ubely@ilbers.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-TUID: Dv7c/0fBvmxg Signed-off-by: Uladzimir Bely --- doc/user_manual.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/user_manual.md b/doc/user_manual.md index 1da0e9d..c58d8c8 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -786,6 +786,21 @@ This approach prevents duplication of the license files in different packages. The last line in the example above adds recipe to the Isar work chain. +### Compilation of sources from gbp-compatible repository + +gbp or git-buildpackage is a utility that supports maintaining a Debian/Ubuntu package in git. Such kind of repositories can be found on salsa. They might be useful for building unreleased or older packages and patching them. The bbclass for this approach is called `dpkg-gbp`. + +#### Example +``` +inherit dpkg-gbp + +SRC_URI = "git://salsa.debian.org/debian/cowsay.git;protocol=https" +SRC_URI += "file://isar.patch" +SRCREV = "756f0c41fbf582093c0c1dff9ff77734716cb26f" +``` + +For these packages `git` is used as a PATCHTOOL. This means that custom patches should be in format that allows to apply them by `git am` command. + ### Compilation of sources missing the debian/-directory The `debian` directory contains meta information on how to build a package from source. This is roughly speaking "configure", "compile", "install" all described in a Debian-specific way. -- 2.20.1