deploy: 09525e9

en/how-to/recording-stock-split/index.html

@@ -3481,7 +3481,7 @@ <h2 id="use-of-the-built-in-stock-split-function">Use of the built-in Stock spli
 <p>In Figure 1, the share price evolution over the last five years is depicted. Very noticeable, there is a massive drop on between June 3 and 6, 2022. On those dates, the closing prices were <code>$ 2447</code> and <code>$ 124.79</code>, respectively (but remember, you own 20 times more shares). Assume that you have purchased one (pricy) share on January 3, 2022 for the amount of <code>$ 3408</code>.</p>
 <p><figure class="pp-figure" id="_figure-1"><figcaption>Figure 1.  Historical Quotes chart of Amazon (unadjusted prices). </figcaption><img alt="" src="../../reference/view/securities/images/split-stock-amazon-unadjusted-PP.png"></figure></p>
 <p>Quite some confusion arises when you compare this chart with those from most other financial websites; for example, the 5-year chart from <a href="https://www.investing.com/equities/amazon-com-inc">investing.com</a> looks very different.</p>
-<p><figure class="pp-figure" id="_figure-2"><figcaption>Figure 2.  Historical Quotes chart of Amazon (adjusted prices). </figcaption><img alt="" src="../../reference/view/securities/images/split-stock-amazon-adjusted-investing-com.png"></figure></p>
+<p><figure class="pp-figure" id="_figure-2"><figcaption>Figure 2.  Historical Quotes chart of Amazon (adjusted prices). </figcaption><img alt="" src="../reference/view/securities/images/split-stock-amazon-adjusted-investing-com.png"></figure></p>
 <p>Both charts span an identical five-year period. But, while your purchase price was <code>$ 3408</code>, it appears to be priced around <code>$ 150</code> around January 2022. This discrepancy arises because financial websites typically "adjust" all historical prices after a stock split. This adjustment involves recalculating the historical prices before the split, just as the PP's Stock Split function does.</p>
 <p><figure class="pp-figure" id="_figure-3"><figcaption>Figure 3.  Historical Quotes chart of Amazon (adjusted prices). </figcaption><img alt="" src="../../reference/view/securities/images/split-stock-amazon-adjusted-PP.png"></figure></p>
 <div class="admonition important">

en/reference/view/securities/context-menu/index.html

@@ -3457,19 +3457,23 @@ <h1>Context Menu</h1>
 <p><figure class="align-right" style="width:30%" id="_figure-1"><figcaption>Figure 1.  Context menu of a selected security.</figcaption><img alt="" src="../images/mnu-context.png"></figure></p>
 <p>The context menu of a security contains several additional options that are not available within the <code>view menu</code>. You can access the context menu by selecting a security or a security view (e.g., securities account) and right-clicking. A pop-up, as shown in Figure 1, will be displayed.</p>
 <h2 id="stock-split">Stock split ...</h2>
-<p>A stock split increases the number of outstanding shares by issuing additional shares to current shareholders. It does not alter the company’s overall value but adjusts share prices thereby making the stock more accessible to investors.</p>
-<p>For example, an Amazon share has risen to a value of about € 2300 at the beginning of 2022. Amazon approved a 20-for-1 stock split; going into effect on June 6, 2022. In a 20-for-1 stock split, every share of the company’s stock will be split into 20 new shares, each of which would be worth one twentieth of the original share value.</p>
-<p>PP currently supports stock splits via a trick that is not 100% clean; see the <a href="https://forum.portfolio-performance.info/t/aktiensplit-buchen/11758">discussion on the forum</a>. Essentially, it retroactively assumes that the shares have <em>always</em> been split. In the aforementioned scenario of a 20-for-1 stock split, the historical share prices before June 6, 2022, are adjusted to 1/20 of their previous value, while the quantity of units in transactions is multiplied by 20. Please, refer to <a href="../../../../how-to/recording-stock-split/">How-to &gt; Recording Stock split</a> for more detailed and background information.</p>
-<p>Selecting the Stock Split option will initiate a wizard that will guide you through three steps to execute the split. In <strong>Step 1</strong> you define the instrument, the split date, and the split ratio.</p>
-<p>You can use the drop-down menu to select the security if it's not already filled in. The Ex-date (execution date) is the date when the stock exchange first trades the split shares at the adjusted price. For instance, in case of the Amazon split, the Ex-date would be June 6, 2022. Additionally, you'll need to specify the split ratio, such as 20-for-1. It's worth noting that these ratios can also be decimal numbers.</p>
-<p><figure class="pp-figure" id="_figure-2"><figcaption>Figure 2.  Split stock wizard - step 1. </figcaption><img alt="" src="../images/split-stock-wizard-step-1.png"></figure></p>
-<p><strong>Step 2</strong> will show you the impact of this stock split on each transaction (buy, sell, delivery, dividend). In this case, there was only one buy transaction before the split date. It is not necessary to have a recorded transaction on the security to perform a Stock Split.</p>
-<p>You can skip this step and maintain the transactions unchanged by unchecking the <code>Convert transactions</code> option. In this scenario, you can adjust the historical prices in the following step while leaving the quantity of securities unaffected.</p>
-<p><figure class="pp-figure" id="_figure-3"><figcaption>Figure 3.  Split stock wizard - step 2. </figcaption><img alt="" src="../images/split-stock-wizard-step-2.png"></figure></p>
+<p>A stock split is a corporate action where a company adjusts the number of its outstanding shares, either by increasing or decreasing them, while keeping the overall market value of the company unchanged. In a <strong>forward</strong> stock split, e.g. 5-for-1, the number of shares increases and the price per share decreases proportionally. In a <strong>reverse</strong> stock split, e.g. 1-for-5, the number of shares decreases and the price per share increases proportionally. Regardless of the type, the total value of an investor’s holdings remains the same.</p>
+<p>For example, by early 2022, Amazon's stock had risen to approximately 3,000 USD per share, a price too high for most investors (see Figure 2). To address this, Amazon approved a 20-for-1 stock split, which took effect on June 6, 2022. In this split, each existing share of the company's stock was divided into 20 new shares, with each new share worth one-twentieth of the original share price.</p>
+<p><figure class="pp-figure" id="_figure-2"><figcaption>Figure 2.  Historical prices of Amazon.</figcaption><img alt="" src="../images/split-stock-amazon-unadjusted-PP.png"></figure></p>
+<p>The resulting graph of the historical prices (see Figure 2) is unattractive and difficult to interpret; for instance, it’s unclear by how much the stock rises in 2023-2024. PP currently handles stock splits in the same manner as most financial services, but this approach has some disadvantages (see the <a href="https://forum.portfolio-performance.info/t/aktiensplit-buchen/11758">forum discussion</a>). Essentially, it retroactively assumes that the shares have <em>always</em> been split. In the case of the 20-for-1 stock split mentioned earlier, the historical share prices before June 6, 2022, are adjusted to one-twentieth of their original value, while the quantity of shares in transactions is multiplied by 20; hereby breaking the link with the <em>real</em> figures on paper notes. For more detailed information and background, please refer to <a href="../../../../how-to/recording-stock-split/">How-to &gt; Recording Stock Split</a>.</p>
+<p>Selecting the Stock Split option will initiate a wizard that will guide you through three steps to execute the split. In <strong>Step 1</strong> you select the security, and define the split date and the split ratio.</p>
+<p>You can use the drop-down menu to select the security if it's not already filled in. The Ex-date (execution date) is the date when the stock exchange first trades the split shares at the adjusted price. For instance, in case of the Amazon split, the Ex-date would be June 6, 2022. Additionally, you'll need to specify the split ratio, such as 20-for-1. A reverse split would be 1-for-20. It's worth noting that these ratios can also be decimal numbers.</p>
+<p><figure class="pp-figure" id="_figure-3"><figcaption>Figure 3.  Split stock wizard - step 1. </figcaption><img alt="" src="../images/split-stock-wizard-step-1.png"></figure></p>
+<p><strong>Step 2</strong> will show you the impact of this stock split on each transaction (buy, sell, delivery). The result is that the number of shares in your possesion will be changed, according to the split ratio. You can skip this step and maintain the transactions unchanged by unchecking the <code>Convert transactions</code> option. If there aren't any transactions, this step has no effect.</p>
+<p>As can be seen in Figure 2 and 4, there was only one buy transaction on January 3, 2022 (before the split date) of one share. Thus, from Janary 3, 2022 on, you will have 20 shares in your account, given that the default <code>Convert transactions</code> is checked.</p>
+<p>The historical prices can be adjusted in the the following step.</p>
+<p><figure class="pp-figure" id="_figure-4"><figcaption>Figure 4.  Split stock wizard - step 2. </figcaption><img alt="" src="../images/split-stock-wizard-step-2.png"></figure></p>
 <p><strong>Step 3</strong> will show you the converted historical prices. If you don't want to change the historical prices, uncheck <code>Convert historical quotes</code>. It's important to note that only prices before the split date will be changed; e.g. Quote (new). Prices after the split will naturally be automatically adjusted correctly by the exchange market.</p>
-<p><figure class="pp-figure" id="_figure-4"><figcaption>Figure 4.  Split stock wizard - step 3. </figcaption><img alt="" src="../images/split-stock-wizard-step-3.png"></figure></p>
-<p>In the chart view of the historical prices, a small dashed vertical line will indicate the Stock split. With the menu <code>Configure Chart &gt; Marking &gt; Events</code> (Gear icon) you can toggle this line. You can also delete the event in the Events tab in the bottom panel; see <a href="../all-securities/#chart-menu">Events</a>. This will remove the marker in the chart but will <strong>NOT</strong> remove the split from the transactions and historical prices.</p>
-<p><figure class="pp-figure" id="_figure-5"><figcaption>Figure 5.  Result of Split stock wizard (Amazon). </figcaption><img alt="" src="../images/split-stock-amazon-adjusted-PP.png"></figure></p>
+<p>The conversion is simple math. For example, on June 3 the old price was 2443 USD. The new price will be 1/20 or 122 USD.</p>
+<p><figure class="pp-figure" id="_figure-5"><figcaption>Figure 5.  Split stock wizard - step 3. </figcaption><img alt="" src="../images/split-stock-wizard-step-3.png"></figure></p>
+<p>In the chart view of the historical prices, a small vertical line with the split ratio at the bottom will indicate the Stock split. With the <img alt="⚙" class="twemoji" src="https://cdn.jsdelivr.net/gh/jdecked/twemoji@15.0.3/assets/svg/2699.svg" title=":gear:"> menu <code>Configure Chart &gt; Marking &gt; Events</code> you can toggle this line. You can also delete the event in the Events tab in the bottom panel; see <a href="../all-securities/#chart-menu">Events</a>. This will remove the marker in the chart but will <strong>NOT</strong> remove the split from the transactions and historical prices.</p>
+<p><figure class="pp-figure" id="_figure-6"><figcaption>Figure 6.  Result of Split stock wizard (Amazon). </figcaption><img alt="" src="../images/split-stock-amazon-adjusted-PP.png"></figure></p>
+<p>Please note the difference between this chart and Figure 2. The rise in 2023 and 2024 is clearly visible, with prices before June 6, 2022 aligning with the adjusted prices. For example, the Buy transaction on January 3, 2022, of one share at approximately 3,400 USD is now shown as a Buy transaction of 20 shares at around 170 USD each.</p>
 
 
 
@@ -3490,7 +3494,7 @@ <h2 id="stock-split">Stock split ...</h2>
     <span class="md-icon" title="Last update">
       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1-2.1-2M12.5 7v5.2l4 2.4-1 1L11 13V7h1.5M11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2v1.8Z"/></svg>
     </span>
-    <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">May 6, 2024</span>
+    <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">September 16, 2024</span>
   </span>