blocks|key|2870037|text|这些字段来自包的.cabal文件，该文件列出了包的一些元数据。许多字段可以具有自由形式的值，因此开发人员可以自己决定在该字段中写入什么，并且对于每个字段不能包含的内容没有固定的“规则”。|type|unstyled|depth|inlineStyleRanges|offset|length|style|CODE|entityRanges|data|2870038|可移植性：描述了软件包在Haskell编译器之间的可移植性，有时也描述了操作系统之间的可移植性。我看到的唯一值是“可移植的”和“不可移植的”。不可移植包可能依赖于只存在于GHC编译器中的Haskell语言扩展，并且不适用于任何其他Haskell编译器，例如UHC，或者可能依赖于某些仅存在于UNIX中而不能在Windows中运行的系统库。|BOLD|2870039|稳定性：指定了一个库有多稳定，这包括它的可靠性(例如，它崩溃的频率)，但最重要的是它的API改变的频率。我已经看到了“实验性”、“临时”和“稳定”的值，但可能会有更多的列表(在Cabal文档中有时无法找到)。当一个包是实验性的，这意味着它的接口可能会在每个版本之间发生变化，因为开发人员还没有决定如何实现它，或者因为开发人员只是在某个地方实现了一些理论上的功能，并不打算维护这个包；他/他只是想实现这个功能，看看它是否可能，并将这个包作为一个演示发布。当一个包是临时的，这意味着一般的API是稳定的，因此可能会有包的更新，只修复内部错误，不添加或删除任何函数。然而，由于它是临时的，当开发人员决定添加新功能或重构库时，它可能会在未来发生变化。有了一个稳定的库，这基本上永远不会发生；API可能永远不会改变，而且实现是“坚如磐石”的，或者是API的参考实现或其他什么。|2870040|包的maintainer是负责包的个人或人员组。电子邮件指定了如何联系到这些维护者。|2870041|"Safe+Haskell“字段指的是一个GHC扩展，您可以阅读有关here的更多信息。一个不安全的模块使用了像unsafePerformIO这样的函数，它破坏了Haskell的一些基本“规则”，比如引用透明性。不安全的模块也可能使用不安全的语言扩展。安全模块是不使用任何不安全函数等的模块，也不导入任何其他不安全模块。可信模块使用不安全的函数(直接可信，间接可信)，但作者已经确保模块的公共API安全地隐藏了这一事实，因此从外部看，模块似乎在所有意图和目的上都是安全的。这些是“安全Haskell”字段的选项。|2870042|entityMap|0|LINK|mutability|MUTABLE|url|http://www.haskell.org/ghc/|1|http://www.cs.uu.nl/wiki/UHC/|2|http://www.haskell.org/ghc/docs/7.2.2/html/users_guide/safe-haskell.html^0|8|6|0|0|5|2D|3|0|3K|3|1|0|0|4|0|2|A|0|1|C|1K|F|Y|4|2|0^^$0|@$1|2|3|4|5|6|7|10|8|@$9|11|A|12|B|C]]|D|@]|E|$]]|$1|F|3|G|5|6|7|13|8|@$9|14|A|15|B|H]]|D|@$9|16|A|17|1|18]|$9|19|A|1A|1|1B]]|E|$]]|$1|I|3|J|5|6|7|1C|8|@$9|1D|A|1E|B|H]]|D|@]|E|$]]|$1|K|3|L|5|6|7|1F|8|@$9|1G|A|1H|B|H]]|D|@]|E|$]]|$1|M|3|N|5|6|7|1I|8|@$9|1J|A|1K|B|H]|$9|1L|A|1M|B|C]]|D|@$9|1N|A|1O|1|1P]]|E|$]]|$1|O|3|-4|5|6|7|1Q|8|@]|D|@]|E|$]]]|P|$Q|$5|R|S|T|E|$U|V]]|W|$5|R|S|T|E|$U|X]]|Y|$5|R|S|T|E|$U|Z]]]]

The fields come from the package's <code>.cabal</code> file, which lists some metadata for the package. Many fields can have free-form values, so that the developer decides for him/herself what to write in that field, and there are no fixed "rules" for what each field must not contain.

Portability: Describes how portable the package is between Haskell compilers, and sometimes also between operating systems. The only values I've seen are "portable" and "unportable". An unportable package is a package that maybe depends on a Haskell language extension that only exists in the <a href="http://www.haskell.org/ghc/" rel="noreferrer">GHC</a> compiler, and doesn't work on any other Haskell compiler like <a href="http://www.cs.uu.nl/wiki/UHC/" rel="noreferrer">UHC</a>, or that maybe depends on some system library that only exists in UNIX and doesn't work in Windows.

Stability: Specifies how stable a library is, which includes its reliability (e.g. how often it crashes), but most importantly how often its API changes. I've seen the values "experimental", "provisional" and "stable", but there might be a list with more somewhere (Things in the Cabal documentation are sometimes impossible to find). When a package is experimental, it means that its interface probably changes between every release, because the developer hasn't decided on how it should be implemented yet, or because the developer just implemented some theoretical functionality from a paper somewhere, and doesn't intend to maintain the package; s/he just wanted to implement the functionality to see if it was possible and is publishing the package as a demonstration. When a package is provisional, it means that the general API is stable, so that there might be updates to the package that only fixes internal bugs and doesn't add or remove any functions. Because it is provisional, however, it might change in the future when the developers decide to add new features or restructure the library. With a stable library, this basically never happens; the API will probably never change, and the implementation is "rock solid" or a reference implementation of an API or something.

The maintainer for a package is the person or group of persons who are responsible for the package. The email specifies how these maintainers can be reached.

The "Safe Haskell" field refers to a GHC extension which you can read more about <a href="http://www.haskell.org/ghc/docs/7.2.2/html/users_guide/safe-haskell.html" rel="noreferrer">here</a>. A module which is unsafe uses functions like <code>unsafePerformIO</code> which breaks some of the fundamental "rules" of Haskell like referential transparency. An unsafe module might also use unsafe language extensions. A safe module is a module that doesn't use any unsafe functions etc, and also doesn't import any other unsafe modules. A trusted module uses unsafe functions (Directly trustworthy, indirectly trusted), but the author has made sure that the public API of the module hides this fact safely, so that from the outside it seems like the module is safe for all intents and purposes. Those are the options for the "Safe Haskell" field.

I am currently reading <a href="http://hackage.haskell.org/packages/archive/containers/latest/doc/html/Data-Set.html#t%3aSet">http://hackage.haskell.org/packages/archive/containers/latest/doc/html/Data-Set.html#t:Set</a>

What does following detail convey (to an absolute haskell beginner)?

Portability: portable (Which other are portability value?) 
Stability: provisional (Which other are stability value?) 
Maintainer: libraries@haskell.org 
Safe Haskell: Safe (Is there something unsafe?)

hackage.haskell.org documentation convention meaning

编译器

Windows

我目前正在阅读下面的细节传达了什么(对于一个绝对的haskell初学者)？可移植性:可移植性(还有哪些是可移植性价值？)稳定性:临时性(还有哪些是稳定值？)维护者: libraries@haskell.orgSafe Haskell:安全(有什么不安全的地方吗？)

问hackage.haskell.org文档约定含义
EN

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问hackage.haskell.org文档约定含义EN

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问hackage.haskell.org文档约定含义
EN