* Update reference docs for interfaces and interface instances
* Rename subsection on empty interface instance clauses
* Move empty interface instance example below explanation
* Split 'interface instance in the interface' into its own subsection
* Add code example for interface instance in the interface
* Rephrase docs on interface method types
* Move docs on required interfaces to the bottom
* Add section on interface values
* Explain result of applying a method, highlight 'this' binding
changelog_begin
changelog_end
Co-authored-by: Stefano Baghino <43749967+stefanobaghino-da@users.noreply.github.com>
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
* Extract qualifyLocally in LFConversion
* Update ghc rev
* Add parent type argument to interface instance desugaring types
* Check interface instance parent in LFConversion
* Convert interface instances in interface declarations
* Update daml-test-files to use 'interface instance' syntax
* Update other tests to use 'interface instance' syntax
* Update interface reference docs to use 'interface instance' syntax
* Update other files to use 'interface instance' syntax
* Add todo in DA.Daml.LF.Ast.Pretty
* Add daml-test-files for retroactive interface instances
changelog_begin
changelog_end
Setting the font weight to 500 makes it effectively invisible, at least
in certain configurations (my setup is an Ubuntu 20.04 with Chrome 103).
In my experiments, 600 is the minimal font weight that makes the difference
visible on my setup. In order to keep the appearance of links unchanged,
I also decreased the font weight for links to the same as the body.
Another possibility to make a compromise that could work for different
setups could be to lower the font weight for bold to 600 and have a weight
specific for links at 500. This allows emphasis to appear clearly on setups
with less sophisticated font management but not to exagerated it for links.
changelog_begin
changelog_end
* Add DA_Internal_Interface to convertTypeDef exclusion check
* Move desugared types/values for interface views into DA.Internal.Desugar
* Convert viewtype and view method declarations
* Typecheck view types and view declarations
* Add unit viewtypes to InterfaceChoiceCollision tests
* Add unit viewtypes to more compiler/damlc tests
* Modify empty interfaces/implements to have viewtypes/views
* Add unit viewtypes to remaining Interface tests
* Test for error thrown when viewtype not specified
* Fix daml-lf/ interface tests to use new syntax / unit views
* Add placeholder view of type Unit to TestInterfaces
CHANGELOG_BEGIN
CHANGELOG_END
* Fix typescript interface tests with unit viewtype
* Add unit viewtype to Java & Scala codegen
* Add unit viewtype to triggers tests interface
* Add unit viewtypes to ledger/test-common
* Add unit viewtypes to ledger-service/http-json
* Fix some damlc tests
* Use viewtype syntax in InterfaceViewNonSerializable test
* Remove HasInferfaceView instances in convertBind
* Add unit view to QualifiedInterface.daml test
* Generate HasInterfaceView instances in DataDependencies
* Add unit viewtypes and views to compiler/damlc/tests
* Document reconstruction of HasInterfaceView
* Move desugared types/values for interface views into DA.Internal.Desugar
* Add desugarable function view w/ EViewInterface desugaring
* Remove templateName and viewtype from generated EViewInterface
* Update desugared-daml
* Proof of concept: use _view -> EViewInterface prim via HasInterfaceView
* Move view, HasInterfaceView to DA.Internal.Interface
* Update desugared-daml tests
* Stop removing and re-generating HasInterfaceView instances
* Do not generate docs for generated "_view_" methods
* Report errors with interface TypeConNames prettily
* Fix InterfaceViewNotSpecified @ERROR to reflect new error text
* Don't import magic `view` method from Prelude to avoid name clash
* Update shake interface goto definition test locations
* Temp disable view spec tests, will re-implement views in speedy
* Add unit viewtype to Java code snippet docs
* Update Interface syntax docs for views
* Add unit viewtype to Transferrable.daml
* Add back "empty" interface implementation to interfaces.rst
* Re-enable view tests by having _view methods on InterfaceViews.daml file
* Remove deprecated commented-out view desugaring code
* Clarify resolution of templates without package ID
In particular, with regards to the HTTP JSON API service.
changelog_begin
changelog_end
* Emphasize use case for package ID resolution
Suggested by @garyverhaegen-da
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
* Emphasize further
* Fix RST formatting
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
* Improve the documentation to run Daml script on Canton
CHANGELOG_BEGIN
CHANGELOG_END
* hints to synchronize contracts
* Fixup sphinx syntax in Daml Script on Canton docs
Annoyingly sphinx links are kinda confusing made worse by the fact
that we need to reference stuff defined in the Canton repo docs.
changelog_begin
changelog_end
Co-authored-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org>
A couple snippets seemed to have drifted. Rather than fix the line
numbers and risk having them drift again, this PR switches the references
to using comments instead, which should hopefully be more future-proof.
CHANGELOG_BEGIN
CHANGELOG_END
CHANGELOG_BEGIN
- [JSON API] For exercise endpoints, when multiple choices with the same
name are defined, the one directly defined on the ``templateId``,
which may be a template or interface ID, will be selected; if a
template ID is specified that only inherits the choices with the same
name, the new ``choiceInterfaceId`` option must be specified to select
the source of the choice.
CHANGELOG_END
The reference to the actual file has been moved above the
paragraph I edited. Removing the reference seems to work.
I also replaces an instance of non-capitalized ID since
I was there.
changelog_begin
changelog_end
changelog_begin
changelog_end
It ended up causing the images to be stretched. The formatting is taken
care of in the CSS and doesn't need to be adjusted in the RST.
changelog_begin
Bumped the GSON dependency in the Java quickstart template to 2.9.0 to avoid users to be exposed to https://www.cve.org/CVERecord?id=CVE-2022-25647 by mistake
changelog_end
Removed reference to installing Canton, per conversation in #product-docs on June 21.
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
It appears we no longer have a page on digitalasset.com, so I am linking
to the official VMware docs. This also fixes a typo.
changelog_begin
changelog_end
* Add completion offset to cmd submission responses
changelog_begin
- [HTTP-JSON] there is now a new meta field called deduplicationPeriod for cmd submissions with which one can specify the deduplication period. Moreover there also is another new meta field submissionId for the cmd submissions.
- [HTTP-JSON] Calls to endpoints for command submission now include the completion offset
changelog_end
Co-authored-by: Raymond Roestenburg <98821776+ray-roestenburg-da@users.noreply.github.com>
* Add the Parties and Users Blog Post to the docs
[CHANGELOG_BEGIN]
Adding the blog post that addresses changes in parties and users from 1.18 to 2.0 to our permanent documentation
[CHANGELOG_END]
* Update parties-users.rst
[CHANGELOG_BEGIN]
Adjusted for @jwhyte-da's comment
[CHANGELOG_END]
* Update docs/source/app-dev/parties-users.rst
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: Stephen Compall <stephen.compall@daml.com>
* Update docs/source/app-dev/parties-users.rst
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: Stephen Compall <stephen.compall@daml.com>
* Update docs/source/app-dev/parties-users.rst
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: Stephen Compall <stephen.compall@daml.com>
* Update docs/source/app-dev/parties-users.rst
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: Stephen Compall <stephen.compall@daml.com>
* Update docs/source/app-dev/parties-users.rst
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: Stephen Compall <stephen.compall@daml.com>
* Update parties-users.rst
[CHANGELOG_BEGIN]
Addressing comments; removed SDK 1.8 and earlier section
[CHANGELOG_END]
* fix links
Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
Co-authored-by: Stephen Compall <stephen.compall@daml.com>
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
* Fix for unclear installation instructions
An attempted fix to the unclear installation instructions. This is based on the most recent version of Canton installation instructions I could find from before the merge, dated Dec. 22, 2021
[CHANGELOG_BEGIN]
[CHANGELOG_END]
* Update docs/source/getting-started/installation.rst
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: Stephen Compall <stephen.compall@daml.com>
Co-authored-by: carrie-laben <91496516+carrie-laben@users.noreply.github.com>
Co-authored-by: Stephen Compall <stephen.compall@daml.com>
- The "version replacement" step was broken: it replaced
`0.0.0-SDKVERSION` with `{sdk_version}` instead of the current SDK
version. This is fixed by adding a `format` call in the `ts_docs`
Bazel rule.
- The section removal was broken as it assumed the version number was
not replaced at all (so tried to detect `0.0.0-SDKVERSION` still).
This is fixed by using a more robust "section removal" method.
CHANGELOG_BEGIN
CHANGELOG_END
Correct metrics documentation shipped with the sdk
* Remove references to obsolete metrics for participant-side de-duplication
* Correct the names of the connection pool metrics
* Add a mention about internal service metrics
* Correct the name for the string interning metric
* Remove obsolete sandbox server role
CHANGELOG_BEGIN
Correct the name for the string interning metric from daml_index_db_loadStringInterningEntries to daml_index_db_load_string_interning_entries
CHANGELOG_END
* Update redirects.map
Updated to redirect from outdated versions of the Daml ledgers page to the newest version.
[CHANGELOG_BEGIN]
[CHANGELOG_END]
* Update docs/redirects.map
[CHANGELOG_BEGIN]
[CHANGELOG_END]
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
Co-authored-by: Gary Verhaegen <gary.verhaegen@digitalasset.com>
* new getCompanion methods generated for contract IDs
* document new output for exercise methods
* link to #14039
CHANGELOG_BEGIN
- [Java codegen] ``createAndExercise*`` and ``exerciseByKey*`` methods
are deprecated; instead, use the new ``createAnd().exercise*`` and
``byKey(key).exercise*`` methods.
When the ledger API supports it, interface choices will be reachable
via ``createAnd().toInterface(Ifc.INTERFACE).exercise*`` and
``byKey(key).toInterface(Ifc.INTERFACE).exercise*``, exactly the
syntax supported by contract-ID exercise; see #14056.
CHANGELOG_END
* InterfaceCompanion marker parent
* define INTERFACE singleton class and sole value with every interface
* don't allow instantiation of interface classes; they are never what you want
* use singleton for to<interface>, rename unsafeFrom<interface> to unsafeFromInterface
* rename to<interface> to toInterface
* document Java interface output changes
CHANGELOG_BEGIN
- [Java codegen] For interface types ``Ifc``, the template contract ID
conversion method ``toIfc()`` has been removed and replaced with
``toInterface(Ifc.INTERFACE)``, and the interface contract ID
conversion method ``unsafeFromIfc`` has been replaced with
``unsafeFromInterface``, always the same name.
CHANGELOG_END
This script was introduced to control the date printed in the sitemap.
The sitemap is now produced in the docs repo, so there's little point in
keeping this mechanism.
Moreover, the stamp on the docs build means it gets rebuilt on every
change to the date, i.e. every day, which isn't good for caching.
CHANGELOG_BEGIN
CHANGELOG_END
* shift some generated Contract code to a handwritten superclass
* generate a `COMPANION` for each template
* use the companion in some ledger reading tests
* document changes in template Java codegen
CHANGELOG_BEGIN
- [daml codegen js] Generated templates have types, inherited methods,
and a new static ``COMPANION`` that enable writing more
template-generic utilities directly in Java. New classes
``Contract``, ``ContractWithKey``, and ``ContractCompanion``, have
been introduced; if you are importing
``com.daml.ledger.javaapi.data.codegen.*`` and have imported classes
with these names from any other package, these references will stop
working; use individual imports instead.
See `issue #13724 <https://github.com/digital-asset/daml/pull/13724>`__.
CHANGELOG_END