Zen

Translation

English type: delimited block .
%build
%{Comfignat_make}
25/250 · 25

Sign in to save the translation.

English Portuguese (Brazil) Actions
Ada Packaging Guidelines
Diretrizes de Empacotamento do Ada
This document describes the current policies for packaging Ada programs and libraries for Fedora. These are Ada-specific amendments to the generic Packaging Guidelines. Ada packages must also conform to the link:../[Packaging Guidelines] and the link:../ReviewGuidelines/[Review Guidelines].
Este documento descreve as políticas atuais para empacotar programas Ada e bibliotecas para o Fedora. Estas são alterações específicas da Ada às Diretrizes de Empacotamento genéricas. Os pacotes Ada também devem estar de acordo com o link:../[Diretrizes de Epacotamento] e o link:../ReviewGuidelines/[Review Guidelines].
Compilation
Compilação
Ada code in Fedora *MUST* be compiled using GNAT, the default Ada compiler in Fedora. All packages that contain Ada code *MUST* have “`+BuildRequires: gcc-gnat+`” to ensure that the compiler is available.
O código Ada no Fedora *DEVE* ser compilado usando GNAT, o compilador Ada padrão no Fedora. Todos os pacotes que contêm código Ada *DEVEM* ter “`+BuildRequires: gcc-gnat+`” para garantir que o compilador esteja disponível.
The GNAT tools are usually invoked through the builder GPRbuild, so Ada packages typically need “`+BuildRequires: gprbuild+`”.
 
There are a number of RPM macros that contain Fedora’s standard compiler and linker flags adapted for GNAT. The appropriate macro *MUST* be used in the build stage. The right macro to use depends on what build tools the package uses.
Existem várias macros RPM que contêm o compilador e de linker padrão do Fedora e flags adaptadas para GNAT. A macro apropriada *DEVE* ser usada no estágio de construção. A macro certa a ser usada depende de quais ferramentas de construção o pacote usa.
For packages that are built with GPRbuild or Gnatmake but without Comfignat there are the macros +++<var>GPRbuild_flags</var>+++ and +++<var>Gnatmake_flags</var>+++, which contain builder, compiler and linker flags.
Para pacotes que são construídos com Gnatmake ou GPRbuild, mas sem Comfignat, existem as macros +++<var>Gnatmake_optflags</var>+++ e +++<var>GPRbuild_optflags</var>+++, que contêm builder, flags de compilador e linker.
In case a package’s build system invokes the underlying GNAT tools without using GPRbuild or Gnatmake, then the appropriate macro for each tool *MUST* be used. If for example Gnatlink is invoked directly, then the expansion of +++<var>Gnatlink_flags</var>+++ shall be passed to it.
No caso de o sistema de compilação de um pacote invocar as ferramentas GNAT subjacentes sem usar Gnatmake ou GPRbuild, a macro apropriada para cada ferramenta *DEVE* ser usada. Se, por exemplo, Gnatlink for invocado diretamente, então a expansão de +++<var>Gnatlink_flags</var>+++ deve ser passada para ele.
For packages whose build systems use Comfignat there is the macro +++<var>Comfignat_make</var>+++. It expands to a Make command with appropriate values for Comfignat’s configuration variables, including builder, compiler and linker flags, directory variables and the directories project. Use it alone to build the default target:
Para pacotes cujos sistemas de construção usam Comfignat, existe a macro +++<var>Comfignat_make</var>+++. Ele se expande para um comando Make com valores apropriados para as variáveis de configuração do Comfignat, incluindo flags do construtor, compilador e linker, variáveis de diretório e o projeto de diretórios. Use-o sozinho para construir o destino padrão:
%build
%{Comfignat_make}
%build
%{Comfignat_make}
If needed, a different target and/or additional variables may be appended:
Se necessário, um alvo diferente e/ou variáveis adicionais podem ser anexados:
%{Comfignat_make} demo_programs atomic_doodads=true
%{Comfignat_make} demo_programs atomic_doodads=true
For the installation stage of Comfignat-using packages, the macro +++<var>make_install</var>+++ (*not* +++<var>makeinstall</var>+++) is recommended.
Para o estágio de instalação de pacotes que usam Comfignat, a macro +++<var>make_install</var>+++ (*não* +++<var>makeinstall</var>+++) é recomendada.
The macros +++<var>GPRbuild_arches</var>+++ and +++<var>GNAT_arches</var>+++ expand to a list of architectures where GNAT packages are available in Fedora. When there is a need to prevent attempts to build an Ada package on secondary architectures where GNAT has not been bootstrapped, this *MUST* be done with either “`+ExclusiveArch: %{GPRbuild_arches}+`” or “`+ExclusiveArch: %{GNAT_arches}+`”.
A macro +++<var>GNAT_arches</var>+++ se expande para uma lista de arquiteturas onde os pacotes GNAT estão disponíveis no Fedora. A partir do Fedora 18, quando houver necessidade de evitar tentativas de construir um pacote Ada em arquiteturas secundárias onde GNAT não foi inicializado, isso *DEVE* ser feito com “`+ExclusiveArch:% {GNAT_arches}+`”.
All packages that contain Ada code *MUST* have “`+BuildRequires: fedora-gnat-project-common+`” to ensure that the necessary RPM macros are defined.
Todos os pacotes que contêm código Ada *DEVEM* ter “`+BuildRequires: fedora-gnat-project-common+`” para garantir que as macros RPM necessárias sejam definidas.
If the upstream source package comes with a build system, for example a GNAT project file or makefiles and a configuration script, then it’s probably best to use that if possible. If not, it is recommended that the packager write a GNAT project file and use GPRbuild to control the compilation.
Se o pacote de origem upstream vier com um sistema de construção, por exemplo, um arquivo de projeto GNAT ou makefiles e um script de configuração, então provavelmente é melhor usar isso, se possível. Caso contrário, é recomendado que o empacotador escreva um arquivo de projeto GNAT para controlar a compilação.
Trampolines
 
An executable stack has been made a linker error in Fedora. This can affect Ada packages because https://gcc.gnu.org/onlinedocs/gccint/Trampolines.html[GCC uses trampolines] to implement some language constructs. The compiler’s usage of trampolines has been greatly reduced, but https://gcc.gnu.org/onlinedocs/gnat_rm/No_005fImplicit_005fDynamic_005fCode.html[some cases remain]. One case that occurs is when a nested subprogram in Ada is passed as a callback routine to a function written in C – which means that the executable stack is also exposed to C code that may contain buffer overflows. In such cases the options are to explicitly allow an executable stack by passing “`+-largs -Wl,--no-warn-execstack+`” to GPRbuild, or restructure the code to eliminate the need for trampolines. Which option is best may depend on how exposed the program is to potentially hostile input.
 
Correct usage of the RPM macros should result in a warning message from the compiler that points out where in the code a trampoline is needed.
 
Runpaths
Runpaths
GPRbuild adds a runpath to the built binaries by default. Fedora’s builder flags normally include an option to disable the automatic runpath. There are however cases where it would be advantageous to allow a runpath. Libraries can have test suites or auxiliary programs that aren’t installed but run during the build and need to link to the library in the build directory, and they may rely on an automatic runpath for this. In those cases the spec file may define a macro named +++<var>GNAT_add_rpath</var>+++. The builder will then be allowed to add a runpath in those parts of the spec file where +++<var>GNAT_add_rpath</var>+++ is defined.
Gnatmake e GPRbuild adicionam um runpath aos binários construídos por padrão. As flags do builder do Fedora normalmente incluem uma opção para desabilitar o runpath automático. No entanto, há casos em que seria vantajoso permitir um caminho de execução. As bibliotecas podem ter suítes de teste ou programas auxiliares que não são instalados, mas são executados durante a compilação e precisam ser vinculados à biblioteca no diretório de compilação, e podem contar com um caminho de execução automático para isso. Nesses casos, o arquivo de especificação pode definir uma macro chamada +++<var>GNAT_add_rpath</var>+++. Os construtores terão então permissão para adicionar um caminho de execução nas partes do arquivo de especificação onde +++<var>GNAT_add_rpath</var>+++ é definido.
+++<var>GNAT_add_rpath</var>+++ does not exempt a package from the Packaging Guidelines. link:../#_beware_of_rpath[The policy on runpaths] still applies.
 
Devel packages
Pacotes de desenvolvimento
Ada library packages *MUST* have a -devel subpackage containing all the files that are necessary for compilation of code that uses the library. This includes +Ada specification files (*.ads), Ada body files (*.adb), Ada library information files (*.ali) and GNAT project files (*.gpr).+ (There is no requirement to include all body files. Typically only some body files are needed.)
Os pacotes da biblioteca Ada *PRECISAM* ter um subpacote de nível contendo todos os arquivos necessários para a compilação do código que usa a biblioteca. Isso inclui arquivos de especificação +Ada (*.ads), arquivos de corpo Ada (*.adb), arquivos de informações de biblioteca Ada (*.ali) e arquivos de projeto GNAT (*.gpr).+ (Não há requisito para incluir todo o corpo arquivos. Normalmente, apenas alguns arquivos do corpo são necessários.)
The -devel package *MUST NOT* contain any makefiles or other files that are only used for recompiling the library.
O pacote -devel *NÃO DEVE* conter nenhum makefiles ou outros arquivos que são usados apenas para recompilar a biblioteca.

Loading…

User avatar farribeiro

Marked for edit
%build
%{Comfignat_make}
%build
%{Comfignat_make}
3 years ago
Browse all string changes

Things to check

Unchanged translation

Source and translation are identical

Reset

Glossary

English Portuguese (Brazil)
build construir fedora-docs-l10n/packaging-guidelines

5989562 String information

Source string description
type: delimited block .
Flags
no-wrap
Source string location
pages/Ada.adoc:44
String age
4 years ago
Last updated
5 months ago
Source string age
4 years ago
Translation file
po/pt_BR/master/pages/Ada.po, string 10