From 9ecf430dde4e50772a93567190f0384d58db9f69 Mon Sep 17 00:00:00 2001
From: Ross Nicoll
Date: Mon, 9 May 2016 17:37:05 +0100
Subject: [PATCH] Update documentation to match PartyAndReference naming
---
docs/build/html/_sources/codestyle.txt | 9 ++-
docs/build/html/api/alltypes/index.html | 2 +-
.../api/contracts/-cash/-state/-init-.html | 2 +-
.../api/contracts/-cash/-state/deposit.html | 2 +-
.../api/contracts/-cash/-state/index.html | 4 +-
.../api/contracts/-cash/generate-issue.html | 4 +-
.../build/html/api/contracts/-cash/index.html | 2 +-
.../-commercial-paper/-state/-init-.html | 2 +-
.../-commercial-paper/-state/index.html | 6 +-
.../-commercial-paper/-state/issuance.html | 2 +-
.../-state/with-issuance.html | 4 +-
.../-commercial-paper/generate-issue.html | 4 +-
.../contracts/-commercial-paper/index.html | 2 +-
.../-crowd-fund/generate-register.html | 4 +-
.../html/api/contracts/-crowd-fund/index.html | 2 +-
.../-dummy-contract/generate-initial.html | 4 +-
.../api/contracts/-dummy-contract/index.html | 2 +-
.../api/core/-party-and-reference/-init-.html | 16 +++++
.../api/core/-party-and-reference/index.html | 57 +++++++++++++++++
.../api/core/-party-and-reference/party.html | 15 +++++
.../core/-party-and-reference/reference.html | 15 +++++
.../core/-party-and-reference/to-string.html | 15 +++++
docs/build/html/api/core/-party/index.html | 4 +-
docs/build/html/api/core/-party/ref.html | 4 +-
docs/build/html/api/core/index.html | 4 +-
docs/build/html/api/index-outline.html | 64 +++++++++----------
docs/build/html/codestyle.html | 8 +++
docs/source/codestyle.rst | 9 ++-
28 files changed, 204 insertions(+), 64 deletions(-)
create mode 100644 docs/build/html/api/core/-party-and-reference/-init-.html
create mode 100644 docs/build/html/api/core/-party-and-reference/index.html
create mode 100644 docs/build/html/api/core/-party-and-reference/party.html
create mode 100644 docs/build/html/api/core/-party-and-reference/reference.html
create mode 100644 docs/build/html/api/core/-party-and-reference/to-string.html
diff --git a/docs/build/html/_sources/codestyle.txt b/docs/build/html/_sources/codestyle.txt
index 681884292c..2e15c7fd28 100644
--- a/docs/build/html/_sources/codestyle.txt
+++ b/docs/build/html/_sources/codestyle.txt
@@ -52,6 +52,14 @@ Code is vertically dense, blank lines in methods are used sparingly. This is so
We use spaces and not tabs.
+1.2 Naming
+----------
+
+Naming generally follows Java standard style (pascal case for class names, camel case for methods, properties and
+variables). Where a class name describes a tuple, "And" should be included in order to clearly indicate the elements are
+individual parts, for example ``PartyAndReference``, not ``PartyReference`` (which sounds like a reference to a
+``Party``).
+
2. Comments
###########
@@ -177,4 +185,3 @@ instead do this
The latter is easier to catch and handle if later necessary, and the type name should explain what went wrong.
Note that Kotlin does not require exception types to be declared in method prototypes like Java does.
-
diff --git a/docs/build/html/api/alltypes/index.html b/docs/build/html/api/alltypes/index.html
index 3cb9c2ed05..a569f7d2c6 100644
--- a/docs/build/html/api/alltypes/index.html
+++ b/docs/build/html/api/alltypes/index.html
@@ -918,7 +918,7 @@ functionality to Java, but it wont arrive for a few years yet
-core.PartyReference |
+core.PartyAndReference
Reference to something being stored or issued by a party e.g. in a vault or (more likely) on their normal
ledger. The reference is intended to be encrypted so its meaningless to anyone other than the party.
diff --git a/docs/build/html/api/contracts/-cash/-state/-init-.html b/docs/build/html/api/contracts/-cash/-state/-init-.html
index 2d4898ad5b..fee165d2a1 100644
--- a/docs/build/html/api/contracts/-cash/-state/-init-.html
+++ b/docs/build/html/api/contracts/-cash/-state/-init-.html
@@ -7,7 +7,7 @@
contracts / Cash / State / <init>
<init>
-State(deposit: PartyReference, amount: Amount, owner: PublicKey)
+State(deposit: PartyAndReference, amount: Amount, owner: PublicKey)
A state representing a cash claim against some party
diff --git a/docs/build/html/api/contracts/-cash/-state/deposit.html b/docs/build/html/api/contracts/-cash/-state/deposit.html
index 5719392e4d..302d5c7438 100644
--- a/docs/build/html/api/contracts/-cash/-state/deposit.html
+++ b/docs/build/html/api/contracts/-cash/-state/deposit.html
@@ -8,7 +8,7 @@
deposit
-val deposit: PartyReference
+val deposit: PartyAndReference
Where the underlying currency backing this ledger entry can be found (propagated)
diff --git a/docs/build/html/api/contracts/-cash/-state/index.html b/docs/build/html/api/contracts/-cash/-state/index.html
index 07026c7fea..a4355918d8 100644
--- a/docs/build/html/api/contracts/-cash/-state/index.html
+++ b/docs/build/html/api/contracts/-cash/-state/index.html
@@ -18,7 +18,7 @@
|
<init> |
-State(deposit: PartyReference, amount: Amount, owner: PublicKey) A state representing a cash claim against some party
+State(deposit: PartyAndReference, amount: Amount, owner: PublicKey) A state representing a cash claim against some party
|
@@ -43,7 +43,7 @@
deposit |
-val deposit: PartyReference Where the underlying currency backing this ledger entry can be found (propagated)
+val deposit: PartyAndReference Where the underlying currency backing this ledger entry can be found (propagated)
|
diff --git a/docs/build/html/api/contracts/-cash/generate-issue.html b/docs/build/html/api/contracts/-cash/generate-issue.html
index 38be4af60c..40c68d08f2 100644
--- a/docs/build/html/api/contracts/-cash/generate-issue.html
+++ b/docs/build/html/api/contracts/-cash/generate-issue.html
@@ -7,8 +7,8 @@
contracts / Cash / generateIssue
generateIssue
-
-fun generateIssue(tx: TransactionBuilder, amount: Amount, at: PartyReference, owner: PublicKey): Unit
+
+fun generateIssue(tx: TransactionBuilder, amount: Amount, at: PartyAndReference, owner: PublicKey): Unit
Puts together an issuance transaction for the specified amount that starts out being owned by the given pubkey.
diff --git a/docs/build/html/api/contracts/-cash/index.html b/docs/build/html/api/contracts/-cash/index.html
index 4663b87d2d..b6b628d0c8 100644
--- a/docs/build/html/api/contracts/-cash/index.html
+++ b/docs/build/html/api/contracts/-cash/index.html
@@ -73,7 +73,7 @@ the same transaction.
generateIssue |
-fun generateIssue(tx: TransactionBuilder, amount: Amount, at: PartyReference, owner: PublicKey): Unit Puts together an issuance transaction for the specified amount that starts out being owned by the given pubkey.
+fun generateIssue(tx: TransactionBuilder, amount: Amount, at: PartyAndReference, owner: PublicKey): Unit Puts together an issuance transaction for the specified amount that starts out being owned by the given pubkey.
|
diff --git a/docs/build/html/api/contracts/-commercial-paper/-state/-init-.html b/docs/build/html/api/contracts/-commercial-paper/-state/-init-.html
index 6f950169b3..3d39997a1b 100644
--- a/docs/build/html/api/contracts/-commercial-paper/-state/-init-.html
+++ b/docs/build/html/api/contracts/-commercial-paper/-state/-init-.html
@@ -7,7 +7,7 @@
contracts / CommercialPaper / State / <init>
<init>
-State(issuance: PartyReference, owner: PublicKey, faceValue: Amount, maturityDate: Instant)
+State(issuance: PartyAndReference, owner: PublicKey, faceValue: Amount, maturityDate: Instant)